TABLE OF CONTENTS
- 1. Overview & Introduction
- 2. Prerequisites & Requirements
- 3. Getting Started
- 4. Core Features & Functions
- 5. Step‑by‑Step Workflow
- 6 Import Learning Objectives from XLSX File
- 8. Technical Information
- 9. Troubleshooting
1. Overview & Introduction
Local, site, and school learning objective repositories allow organisations to create and maintain curriculum structures tailored to their needs. These repositories exist alongside any national repository but operate independently. Administrators can organise subjects, categories, and learning objectives to reflect local programmes of study. Once published, these learning objectives can be added to courses for planning, assessment, metadata tagging, and reporting.
2. Prerequisites & Requirements
- Permissions:
- Users must have the Learning objectives repository management right for the relevant school or site. This right is granted to system administrators by default but may be assigned to other profiles or policies.
- Access to a school repository is granted through the School option in a profile or policy.
- Access to all repositories on site level is granted through the Site option.
- Browser: A modern browser supported by itslearning.
- Dependencies:
- Learning objectives must be published before teachers can add them to courses.
3. Getting Started
Basic Setup
Initial Configuration
4. Core Features & Functions
- Publishing:
Subjects must be published before teachers can add their objectives to courses. Published subjects display a green icon; unpublished show red. - Metadata use:
Learning objectives serve as metadata in My Library to support content search. - Learning objectives in the repository can include criteria and descriptors when rubrics exist.
5. Step‑by‑Step Workflow
5.1. Access a Local/Site/School Repository
- Click Admin in the top menu.
- Select Learning objective repository.

- Choose the desired school or site repository if more than one is available.
- If the user has access to only one, it opens automatically

5.2. Create the Structure (Folders, Subjects, Categories)
- Open the repository root folder.
- Click Add folder to create organisational levels (e.g., Primary).

- Provide a Title and ID (required). The description is optional.
- Click Save.

6. To create a subject, click Add subject inside a folder.

7. This page will open

8. Now you can add categories as needed using Add category.

5.3. Add Learning Objectives
- Open the subject or category.
- Click Add learning objective.
- Enter a Title and ID.
- Optionally enter a description (plain text only).
- Click Save.

5.4 Adding rubrics (Optional)
If you want ready made rubrics you need to add criteria and descriptors in the learning objective.
- When Criterion is added, you need to create a descriptor for each level:

5.5 Publish the learning objectives
- Open the subject.
- Click Publish.
- Confirm the action.
- The icon turns green once published.
- Deleting items in a published subject prompts a confirmation due to course impact.

5.5. Add Learning Objectives to a Course (teacher side of itslearning)
- Open the course.
- Navigate to Settings → Learning objectives.
- Click Find.
- Choose the repository type: School, Site, or Global (if applicable).
- Select a subject or category.
- Click Insert to add the objectives to the course.
Teachers may now connect these learning objectives to elements such as assignments, planner items, and tests.
6 Import Learning Objectives from XLSX File
You can create and import a complete learning objective repository structure using an XLSX file. This method is useful when preparing large curriculum structures externally before uploading them to itslearning.
File Requirements
- File format: XLSX only
- Maximum file size: 10 MB
- Required columns: ID, ParentID, Title, Description, Type (exact spelling required)
6.1 XLSX File Structure
The file uses a hierarchical structure where each row represents one element, and the ParentID column links elements to their parent level.
Required Columns
| Column | Description | Required |
|---|---|---|
| ID | Unique identifier for the element | Yes |
| ParentID | ID of the parent element (blank for top-level folder) | Yes (except root folder) |
| Title | Display name | Yes |
| Description | Additional information about the element | No |
| Type | Element type: Folder, Subject, Category, LO, Criterion, or Descriptor | Yes |
Element Types
| Type | Description | ParentID Should Reference |
|---|---|---|
| Folder | Organises subjects by educational level (e.g., Primary, Secondary) | Leave blank for root folder |
| Subject | Contains learning objectives for a specific subject (e.g., Mathematics, English) | A Folder ID |
| Category | Organises learning objectives within a subject (e.g., Year 3, Addition) | A Subject ID or another Category ID |
| LO | The actual learning objective | A Subject ID or Category ID |
| Criterion | Assessment criterion for a learning objective (optional) | An LO ID |
| Descriptor | Performance level description for a criterion (optional) | A Criterion ID |
6.2 Creating the XLSX File
1. Set Up the Spreadsheet
- Open Excel or another spreadsheet application
- Create a new sheet
- Add the following column headers in row 1:
ID | ParentID | Title | Description | Type
Note! The column headers must be typed exactly as shown (case-sensitive)
2. Add a Root Folder
- In row 2, create your top-level folder:
- ID: MAT
- ParentID: (leave blank)
- Title: Mathematics
- Description: Mathematics curriculum structure
- Type: Folder
This creates the main container for your curriculum structure.
3. Add Subjects
- Add one row for each subject you want to include
- Set ParentID to match the folder ID (e.g., MAT)
- Set Type to Subject
- Use short, unique IDs (e.g., MAT_NUM)
- Provide clear titles (e.g., Numbers and operations)
Example:
- ID: MAT_NUM
- ParentID: MAT
- Title: Numbers and operations
- Description: Working with whole numbers, fractions, and decimals
- Type: Subject
4. Add Categories (Optional)
Categories help organise learning objectives within subjects. You can nest categories within other categories to create deeper structures.
- Add a row for each category
- Set ParentID to the subject ID or another category ID
- Set Type to Category
- Provide a descriptive title (e.g., Year 3, Calculation)
Example:
- ID: MAT_NUM.3
- ParentID: MAT_NUM
- Title: Working with whole numbers
- Description: Year 3 number objectives
- Type: Category
5. Add Learning Objectives
- Add a row for each learning objective
- Set ParentID to the subject ID or category ID where it belongs
- Set Type to LO
- Provide a clear, specific title describing the skill or knowledge
Example:
- ID: MAT_NUM.3_CALC_1
- ParentID: MAT_NUM.3
- Title: Add and subtract within 1000
- Description: (optional)
- Type: LO
6. Add Criteria (Optional)
Criteria define assessment standards for learning objectives. Add these only if you use rubrics in your assessments.
- Add a row under the relevant learning objective
- Set ParentID to the learning objective ID
- Set Type to Criterion
- Provide a short title describing what is being assessed
Example:
- ID: MAT_NUM.3_CALC_1_CRIT
- ParentID: MAT_NUM.3_CALC_1
- Title: Strategy use
- Description: (optional)
- Type: Criterion
7. Add Descriptors (Optional)
Descriptors define performance levels for each criterion. You need one descriptor for each performance level in your rubric.
- Add a row for each performance level
- Set ParentID to the criterion ID
- Set Type to Descriptor
- Provide the performance description
Example:
- ID: MAT_NUM.3_CALC_1_DESC1
- ParentID: MAT_NUM.3_CALC_1_CRIT
- Title: Strategy not evident
- Description: (optional)
- Type: Descriptor
Your file should now look like this:
6.3 Import the File
- Save your spreadsheet as an XLSX file
- Navigate to Admin → Learning objective repository in itslearning
- Select the appropriate school or site repository
- Click the Import curriculum button

5. Click Browse and select your XLSX file
6. Click Upload file
7. Review the repository tree structure to verify all elements imported correctly
6.4 Download Example File
An example XLSX file is available in the import interface. Click the here link under "Download an example file" to see a correctly formatted template.

After Import
Once imported:
- All folders, subjects, categories, and learning objectives appear in the repository tree
- Subjects display as unpublished (red icon) until you publish them
- You can edit or add to the structure using the standard interface
- The repository is ready for teachers to use once subjects are published
8. Technical Information
- Update behaviour:
Local repository learning objectives do not sync across sites and cannot be shared with the global community. - Course updates:
When structures change, they synchronise overnight for learning objectives already added to courses. - Metadata:
Learning objectives can be used in My Library searches.
9. Troubleshooting
Subject does not appear when adding objectives to a course
Cause: The subject is not published or belongs to a different repository level.
Solution:
- Open the repository.
- Verify the subject displays the green published icon.
- Confirm the user is connected to the correct school/site.
Prevention: Publish subjects immediately after creating objectives.
Cannot access the repository from the Admin section
Cause: Missing Learning objectives repository management permission.
Solution:
- Edit the user profile or policy.
- Enable Learning objectives repository management at School or Site level.
Prevention: Assign permissions during onboarding for curriculum‑responsible profiles.

