Goal Repository & Goal Sets

Last updated: July 30, 2026

Summary

The Goal Repository allows Template Creators to create and manage Repository Goals that can be reused across multiple Templates.

Goal Sets are groups of Repository Goals that belong together. Goal Sets allow users to select a set of related Goals at once, e.g. when building Templates or viewing progress.

Goal Repository

What is the Goal Repository?

The Goal Repository allows Template Creators to create Goals that can be reused in multiple Templates (see 📄 Templates), making it easy to track growth in a longitudinal way on Goals across Templates. Repository Goals form the foundation of scaffolded Goals that typically represent programme-wide/overarching Goals (e.g. learning outcomes, graduate attribute, skills, or competencies). Template Creators can create new Goals in the Goal Repository and convert existing (single use) Template Goals to Repository Goals.

Note:

Repository Goals can be edited by Template Creators from that Goal's Department. These changes will be reflected in existing Templates that include these Goals. Changes that are made to Repository Goals will only be reflected in learner's Portfolios after they have (re)imported a Template containing that Repository Goal.

How to manage Repository Goals?

Repository Goals can be created and managed by Power Users with Template Creator abilities. More about these abilities can be found in 📄 Super Admins, Power Users, and Departments.

To create or manage repository goals, go to the Scaffolds tab (1). Then click on the Goal Repository tab (2). This table lists all existing Repository Goals. You can use the search bar to find Goals by their names or nicknames. Click ‘+ New repository goal’ (3), to add a new one.

Repository Goal overview

Note:

Super Admins and Functional Managers can manage Repository Goals for all Departments, as well as Repository Goals linked to no Departments (i.e. institution-wide Repository Goals).

How to create and update Repository Goals?

You can create/edit Repository Goals through a CSV import (1) — practical for adding or updating Goals in bulk, or you can create them individually through the User Interface (2) — useful when creating Goals one by one.

Import or create Repository Goals

Through CSV import

When you choose to create Repository goals with a CSV file, you can download an example file (1). The necessary columns are:

sourced_id*

name

nickname

description

parent_goal_id

*The sourced_id is not required, but highly recommended. If you do choose to use the sourced_id, you will overwrite existing content if the ID already exists. Using this ID, you can easily update existing Repository Goals.

Note: Portflow does not issue a sourced_id. This ID is typically issued by the source (e.g. curriculum management system). The ID can also be defined manually. It allows you to update the Repository Goal via CSV later on.

When you want to create a Sub-Goal, you can use the sourced_id of the parent Goal in the column parent_goal_id. If you leave this last column empty, you will create a Goal instead of a Sub-Goal.

If your file is finished, you can upload it (2). In the table with imported jobs, you can find the status of an import (3). If your import was not successful, you can download the error log to see any errors and retry after adjusting the file.

Tip: You can also bulk-update repository goals in the same manner as creating them. To do this, make sure to always add a sourced_id.

Importing Repository Goals

Through the user interface

To create a new Repository Goal, click the + New repository goal button in the Goal Repository.

By clicking on the name of a Repository Goal, you can view and/or edit it.

Note: Power Users can edit Repository Goals of the Department(s) that they belong to. They can only view all Repository Goals from other Departments.

The image below shows an example of a Repository Goal:

  1. Information about the Repository Goal, including its name, nickname, and description.

  2. The Sub-Goals of the Repository Goal.

  3. Edit button. Click the three dots for more options to manage the Repository Goal details.

    1. You can duplicate or delete a Repository Goal if it is in a Department you are part of.

  1. Attachments, which you can add via the edit button

  2. Details of the Repository Goal, e.g. Department and number of times the Goal has been used in Templates.

  3. Add a new Sub-Goal to the Repository Goal.

Repository Goal Card and edit actions.

How to suggest Rubric Scales for Repository Goals?

You can link one or more Rubric Scales (see 📄 Rubric Scales) to suggest to learners when they create a Progress Review. This provides guidance on which Rubric Scale is expected to be used for a given Repository Goal. Learners can select the Rubric Scale they believe best fits their Progress Review Request.

Configure suggested Rubric Scales

  1. Open a Repository Goal and navigate to the Repository Goal details (as described in step 3 in the section above).

  2. Switch to the Rubric Scales tab (1) and click the +Add rubric scale button.

    Add rubric scale
  3. A new pop-up opens. Choose to add a rubric scale for the Goal or its Sub-Goal(s) (3).

  4. Select a Rubric Scale that should be suggested to learners (4). You can add more later.

    Choose between adding a scale for the Goal or Sub-Goals
  5. Click Done (5). Alternatively, you can click Save and add descriptions (6) to immediately add level descriptions for this Rubric Scale.

  6. You can see if/which Rubric Scales are linked, and which Levels are associated with it. If you had already added descriptions, you will see the button Edit descriptions (7). From here, you can also click Add descriptions (8) for Scales that don't have descriptions yet.

    Review linked rubric scales
  7. If you use the button from 6, 7 or 8 (Add/Edit Descriptions), you land in a new pop-up to add descriptions to these Rubric Scale Levels. Click Done to save the descriptions.

    Add or edit Rubric Scale Level Descriptions
  8. When a learner starts a Progress Review that includes the Repository Goal with a suggested Rubric Scale, the suggested Rubric Scale(s) will be displayed in the section ‘Suggested rubric scales’.

    87ace851-8284-4980-874b-c28d3b89d0cb-SuggestedRubricScales.png-c608c706-7094-4e24-b80a-76235eb4c988-2260d382-c5c5-4709-a8e5-717a8954859c

When someone is using the Progress Review that uses the combination of the Repository Goal and Rubric Scale, they will not yet see the descriptions. These will become available in the coming weeks.

Note: It does not matter when the learner has imported the Repository Goal. The suggested Rubric Scales when starting a Progress Review has a live connection to the Repository Goal (determining which Rubric Scales are suggested at that moment).

How to convert existing Template-specific Goals to Repository Goals?

If you already have one or more Goals in a Template, you can convert them to Repository Goals. This way, you don't have to create Repository Goals from scratch. To achieve this, go to a Template which contains Template-specific Goals, go to the Goals section and select the Convert to repository goal option from the action menu (accessible via the three dots ).

If you used Goals in a Template before the Goal Repository was introduced, and you would like to reuse the same Goals in other Templatesyou only need to convert the Goals in the ‘old’ Template to Repository Goals. You can then reuse the Repository Goals in 'new' Template(s). Now, learners can continue working on the same Goal they had imported before.

Note: Converted Goals cannot be converted back.

Converting template-specific goals to repository goals

Goal Sets

What are Goal Sets?

Goal Sets let you group Repository Goals together under a shared theme or purpose, for example: programme-level outcomes, term objectives or module-level objectives. With Goal Sets, you can easily add multiple related Repository Goals to a Template in one go. You can also start with a few Goals from a Goal Set and add more from the same set later in following Templates.

How to create and manage Goal Sets?

Template Creators can create, edit, and delete Goal Sets via the tab Goal Sets (1) within the tab Scaffolds. In this overview, you can see all existing Goal Sets, how many Goals they contain and to which Department they belong. From here, you can also Create a new goal set (2).

Goal set overview

When creating a new Goal Set, you can give it a Name (1) and optionally add an Internal note (2). Use this note to provide guidelines for colleagues who will be working with the Goal Set, or to explain its purpose. You can also assign the Goal Set to a specific Department (3).

Goal set details

Note: Once a Department is selected, only Repository Goals from that same Department can be added to the Goal Set.

After clicking Save, you’ll be taken to the page for the Goal Set you just created. Here, you can view its name and details (1). You can edit (2) the Goal Set (such as updating the name or internal description) and start adding Repository Goals (3) to it. When you add a Repository Goal that contains Sub-Goals, those Sub-Goals will automatically be included in the Goal Set as well.

Viewing and adding Goals to a Goal Set

Once you have added Repository Goals, you can reorder (1) and remove (2) them from the Goal Ret. Removing a Goal from the Goal Set will not delete the Repository Goal.

Actions for Goals in a Goal Set

Note: When creating a new Repository Goal, you can directly assign it to a Goal Set (1) during creation. Both new and existing Repository Goals can be added to or removed from a Goal Set at any time.

Adding Repository Goals to a Goal Set

How to use a Goal Set in a Template?

To add a Goal Set to a Template, start by navigating to the Template and clicking the + Use repository goal button (1). Then, click the Filter button (2) to select a Goal Set.

Filtering on Goal Sets in Templates

Note: For each Repository Goal added to a Template, you can always see whether it belongs to a Goal Set (1), and if so, which one. You can also reorder (2) these Repository Goals or remove (3) them from your Template at any time.

Manage Repository Goals in Templates