A How-to-guide for completing the ILR Template

Introduction

Aptem can prepopulate the Individualised Learner Record (ILR) for every learner enrolled on a programme. Once the template is set up, its information goes into the ILR of every learner added to the programme. You can still change each learner's ILR individually.

The ILR in Aptem

Aptem implements the UK government's ILR specification, so colleges, apprenticeship programmes and training providers can collect the data they need.

You can enable or disable the ILR at programme level.

If the ILR is enabled, learners can complete part of it in their Aptem account. Admins can then review, edit, track and amend ILRs. ILRs can be internally verified, if needed, before they're submitted to the Department for Education (DfE) in a batch file.

When you build a delivery programme for a specific apprenticeship standard, qualification or framework, you can prepopulate defined sections of the ILR for every learner enrolled on it.

  1. From your Aptem account page, select the Programmes tile.
    Picture1.png

  2. Clone a programme, or edit the programme whose ILR you want to prepopulate.

  3. Select the ILR token and complete the template.

Set up the template before you enrol learners

Complete the ILR template before you enrol learners on the programme. The template isn't applied retroactively: if you set it up after learners are enrolled, their ILRs stay blank, or keep the details entered before.

For learners already enrolled when the template was set up, add the aims manually on the Admin tab of each learner's ILR, with the right values. See Qualification and provider details (Admin tab).

You can't disable the ILR token on a sub-programme. If you leave it blank, with no fields filled in, it doesn't create any ILR aims when it's applied to a learner.

 

Completing the ILR template

On the Main tab

Two settings on the Main tab need to be correct:

  • Years: choose the correct academic year.

  • 2026/27 schema: from August 2026, the 2026/27 schema is selected by default for all new, cloned and existing programmes, so you don't need to set it. You can still change the schema on an individual programme. Contact your Customer Success Manager if 2026/27 isn't in the dropdown. See ILR 2026/27 schema selection and getting started.

  • Allow to sign without verification: controls whether learners can sign their ILR before an admin has verified it. We advise ticking it for apprenticeships.

Select Confirm.

Picture2.png

 

Select the Template tab to complete the ILR details.

On the Template tab

You may need to scroll to see all the fields. Complete:


image-20251112-145125 (2).png

  • Programme Type: for an apprenticeship standard at any level, choose apprenticeship standard. For an apprenticeship framework or qualification, choose the right type from the dropdown.

  • Apprenticeship Standard Code: enter the LARS code for the apprenticeship.

  • List of Aim References: select Add new to add them.

  • Financial Records: select Add new to add them.

  • Delivery postcode: this fills the Delivery location postcode on each learner's aims when the programme is first applied. If you leave it blank, the field is filled from the Qualification delivery location postcode when an admin saves the learner's ILR from the Admin tab.

Picture3.png

 

The Qualification delivery location postcode on each aim is filled in automatically from the learner's employer address, if one is selected for the learner, or otherwise from the employer's primary address. It updates when the learner's employer or employer address changes, and stays empty until an employer is linked. It isn't included in the batch file, so it doesn't affect your submissions as long as the delivery location postcode on each aim is correct.

Changes in the 2026/27 schema

These changes apply when the 2026/27 schema is active on a programme. If your tenant still uses the 2025/26 schema, they don't apply.

Hours fields

The Planned Hours and Actual Hours for Off the Job Training fields no longer appear on the ILR aim screen when the 2026/27 schema is active. Hours are recorded in the Hours section on the aim screen instead. See ILR 2026/27: hours and employment status.

Funding Model 39

Funding Model 39 (Growth and Skills Short Course Offer) can be selected on ILR aims with a start date from 1 August 2026.

Assessment organisation

The Assessment Organisation ID field now accepts 8-character identifiers (EPA#### or an 8-digit number). The field label has changed from "End point assessment organisation" to Assessment organisation.

Outcome grade codes

Two more outcome grade codes are available: HP (high pass) and HM (high merit). Both are accepted by the ILR export without validation errors.

RIP: Price Reduction financial type

A new financial type, RIP: Price Reduction, is available in the Financial Records section for eligible apprenticeship aims (FM36; ProgType 25 with FM81). Only one RIP record is allowed per aim.

FUNDCOMP retired

The Completion of Year Instance (FUNDCOMP) field has been removed from the 2026/27 HE Delivery Modal. Data from earlier submissions is kept.

DAM and LDM code changes

  • DAM code 114 (Redundancy eligibility) is available for learning deliveries from 1 August 2026.

  • LDM codes 374 and 396 are valid until 31 July 2026, and can't be selected for deliveries from 1 August 2026.

 

ZPROG Aim and Sub-aim Reference

ZPROG aim

Picture5.png

Sub-aim reference

Picture6.png

Please note, for information regarding the Apprenticeship standard code and sub- aims visit the LARS (Learning Aims Site) site.

 

Apprenticeship standard code search in LARS

Complete these fields:

  • Keyword or code

  • Type of Learning

  • Teaching year

  • Level

Picture7.jpg

-

Picture8.jpg

Leave Keyword or code empty.

Set Type of Learning to Qualifications.

Picture9.jpg

Open the additional filters and choose Category E and the appropriate Sector Subject Area Tier 2. Picture10.png

The sub-aim learning reference number

Picture11.png

Add your financial records on the ILR Template sub-page.

Picture12.png

Then select Confirm or Save. The template's information goes into the ILRs of learners enrolled on the programme.

Note: if you completed learners' ILRs manually before filling in the template, their records aren't updated from the template.

Learning aims

Advanced Learner Loans (ADL)

The ADL option is set on each learning aim, not at programme level. The ADL checkbox shows when you edit a learning aim if the programme type is blank, or programme type 24 is selected. It doesn't show for other programme types. Select it on each relevant aim.

Note: programme type 24 was only valid up to 31 July 2023, and isn't in current ILR specifications.

Care leavers

Care leaver status is recorded on the main aim. To record it:

  1. Open the learner's ILR.

  2. Edit the main aim.

  3. In the Eligibility for enhanced funding field, select the right code.

  4. Save the aim

  5. Save the ILR.

Enter the right code before saving, as an incorrect code can affect funding calculations and reporting.

Recording Skills Bootcamps

To record a Skills Bootcamp, set funding model 37 and programme type 32 on the aims. This shows the Contract reference number field. Enter the learning start date first, as the available funding models depend on it.

Financial records

To add a payment record (PMR) to a learner's ILR:

  1. Select Add next to Apprenticeship Financial Records.

  2. In Financial Type, select PMR - payment record.

  3. Enter the other details and select Add.

Financial records show in the order they were added and saved. You can't sort them by date.

Planned hours

When a programme is applied to a learner, their planned hours are filled in from:

  • the total of the planned hours on the programme's learning plan components,  or otherwise

  • the planned hours in the ILR template, if they're filled in.

Admins can change the hours while applying the programme.

Planned hours only go into the learner's ILR aims when they're first enrolled. After that:

  • Changing planned hours in the learning plan doesn't update the ILR aims. Update the ILR manually.

  • Adding hours to the programme doesn't update learners already enrolled. Update their ILR manually, then update their Training Plan.

Once an ILR has been submitted planned hours should not be changed in the ILR for a learner. Please refer to the apprenticeship funding rules.

When a programme is applied again, for example when you change its dates, the ILR template is used again. If Planned employability, enrichment and pastoral hours is blank in the template, the learner's hours are reset to zero. Fill it in to stop this. For how hours change when learners progress to a sub-programme, see ILR Management: Troubleshooting guide.

Minimum required hours, shown on the learner's dashboard, aren't included in the ILR. They're for reference only, as the ILR doesn't need them. See the ILR specification in the government's submit learner data guidance.

 

Reviewing and editing ILR records 

The template fills in some sections of each learner's ILR. To review and edit a learner's ILR, go to the ILR tile.

Picture13.png

The Individualised Learner Records page lists every user in your Aptem account with an ILR.

You can search by name, unique learner number, learner reference number or status (Newly submitted, Signature Required, Signed, QA Verified or Completed). For what each status means, see ILR statuses and signatures

Picture14.png

Select the edit icon next to a user's name to open their ILR.

The ILR page has two tabs:

  • User: the Learner Details Data Capture Form, which learners usually complete in the Onboarding Wizard. For where its details come from, see Where ILR learner and employment data comes from.

  • Admin: the fields the training provider completes, including qualification aims and learner destination information.

All changes to a learner's ILR are tracked, and previous versions are saved under compliance documents on the learner's profile.

Picture15.png

Creating a learner's ILR

A learner's ILR is created when the learner completes the ILR step of their Onboarding Wizard, or when an admin saves the User tab of their ILR. You can't create an ILR until the User tab has been saved.

If Create ILR on the learner's profile doesn't work:

  1. Open the learner's ILR and select the User tab.

  2. Complete any missing details.

  3. Select Save. This saves the user and aim details and creates the ILR.

Qualification and provider details (Admin tab)

The Admin tab shows ILR sections for provider administration, including ID verification, next of kin, learner funding and monitoring, and sections to add qualification aims and learner destination information.

These details can be prepopulated for a programme (see above), but you can change them on each learner's ILR.

Picture16.png

If you didn't fill in the aims in the ILR template, add them here. Scroll to the bottom of the Admin tab and select Add.

Picture17.png

To change an existing aim, select its pencil icon.

Picture18.pngComplete or change the learning start, delivery and end details, then select Save.

Picture19.png

Was this article helpful?
2 out of 2 found this helpful