Learning Paths in POK
A Learning Path in POK Proof of Knowledge is a structured training journey where a person earns steps (badges or certificates) and automatically receives a final credential once they meet the path's requirements. You build the path out of modules with mandatory and optional steps, issue the steps to recipients, and POK tracks progress and awards the final credential for you.
What is a Learning Path?
A Learning Path lets you define a sequence of steps a person must complete to earn a final credential. Paths are flexible: each module can combine mandatory steps with optional steps, and you can set a minimum number of optional steps that must be completed.
Example
A Business Administration program organized by quarter:
- Quarter 1: all courses are mandatory
- Quarter 2: 4 mandatory courses, plus at least 1 of 3 electives
- Quarter 3: only elective courses, but at least 2 of 5 must be completed
- Quarter 4: elective courses with no minimum requirement
Create a Learning Path
Step 1: Open the Paths section
- Log in to your POK dashboard through the region selector.
- Open the Paths section
- Click New Path
A dialog opens where you enter the name of your path.
Step 2: Create modules and steps
After you confirm the name, you land on the creation screen, where you organize your path into modules. Each module contains two subgroups: mandatory steps and optional steps.
Key concepts on this screen:
- Modules: containers that organize your steps (for example, Quarter 1, Quarter 2)
- Mandatory steps: must be completed to earn the final credential
- Optional steps: the recipient chooses which ones to complete, with or without a minimum requirement
- Module name: the first module has no name by default. From the second module on, modules are named "Module A", "Module B", and so on. You can rename them at any time
Add mandatory steps
-
In the current module, click + Add under "Mandatory"
-
A dialog opens asking for the step name
-
Enter the name (for example, "Introduction to Economics")
-
Confirm
The step appears in the mandatory list. Repeat this process to add all the mandatory steps in the module.
Add optional steps
- In the same module, click + Add under "Optional"
- Enter the step name
- Confirm
If a module has optional steps, you can set a minimum requirement:
- Once you add 2 or more optional steps, a field appears where you choose the minimum number required
- Select how many of the optional steps must be completed (for example, 2 out of 5)
- If you leave the value at 0, the steps are purely optional and the person can earn the final credential without completing any of them
Actions per step
For each step you can:
- Edit: change the name
- Delete: remove the step from the path
- Move: switch a step between mandatory and optional
Add more modules
- Click + Add module
- A new module (Module A, Module B, and so on) is created, which you can rename
- Repeat the process of adding mandatory and optional steps
Requirements to continue
To move on to the next screen, the path must have at least 2 required steps in total. For example:
- 2 mandatory steps in the same module
- 1 mandatory step plus 1 required optional step
- 1 mandatory step in Module A plus 1 mandatory step in Module B
Once you meet this requirement, click Continue.
Important: after you save the path, you cannot delete steps or modules, or move steps between mandatory and optional. Review your structure carefully before continuing.
Step 3: Configure the final credential
On this screen you define the credential that is awarded automatically when all requirements are met.
- Credential Type: choose Certificate or Badge
- Design Type: select one of:
- Certificate only
- Badge only
- Template: select a template you previously created in the "Designs" section
- Custom Page: (optional) assign a credential page for the recipient's view
Credential details
Fill in the fields required by the selected template:
- Credential title
- Institution
- Dynamic attributes (if applicable)
Use the final credential as a step in another path
If this final credential should also count as a step inside another path:
- Check the box "Is part of another learning path"
- New dropdowns appear:
- If the destination path has only 1 module: select the step directly
- If the destination path has multiple modules: choose the module first, then the step
Email configuration
- Email Language: choose the language for the credential emails
Save the path
Click Save Path. The path is ready to use.
Issue the learning path steps
After creating the path, you issue the steps individually to recipients.
-
Go to the Issue section (you can issue manually or in bulk)
-
Select the recipients and the type of issuance
-
In the "Learning Paths" section, check the box "Is part of a learning path"
-
New fields appear:
- Learning Path: select the path you created
- If the path has only 1 module: choose the Step directly
- If the path has multiple modules: select the Module first, then the Step
-
To include more steps from the same path or from other paths, click + Add Step
-
Complete the rest of the issuance settings (design, recipient details, and so on)
-
Proceed with the issuance
Automatic progress tracking
When a person receives a step:
- POK automatically records which step they completed
- If they have completed all mandatory steps plus the minimum optional requirements, they automatically receive the final credential
- If steps are still missing, their progress is updated so they can see what remains
Edit a saved path
Once a path is saved, editing is limited to protect the integrity of your data.
What you can edit:
- All the data of the final credential
What you cannot do:
- Delete steps
- Delete modules
- Move steps between mandatory and optional
- Edit a step that is the final credential of another path
If you need broader changes, contact the POK team.
Learning path metrics and analytics
From the Paths section you can monitor how your paths are performing.
Key metrics per path:
- Total participants: how many people started the path
- Completed the path: how many earned the final credential
- View steps: opens a dialog with the breakdown by step
- Retention: percentage of recipients who completed the path
Breakdown by step
Click View steps to see the details.
- If the path has only 1 module: all steps are listed with the number of credentials awarded
- If the path has multiple modules: each module appears as a dropdown showing:
- The total steps awarded in that module
- When expanded, the detail of each step in the module
With these metrics you can identify which steps perform best, see where people get stuck, measure the efficiency of your training design, and evaluate retention and engagement.
Recipient view: progress in a Learning Path
When a person receives a step that belongs to a path, they see a progress accordion in their credential view.
General information
- Path name
- Total required steps (mandatory steps plus required optional steps)
Structure by module
- If the path has multiple modules, each module title is shown with two subgroups: "Mandatory" and "Optional"
- If the path has only 1 module, no module title is displayed
Mandatory subgroup
Each mandatory step is listed:
- If already completed, it appears as earned
- If not, it appears as a pending step
Optional subgroup with a minimum requirement
The subgroup is labeled "Optional - Required X/Y", where:
- X is the minimum number required
- Y is the total number of optional steps available
For example, "Optional - Required 2/5" means the person must complete at least 2 of the 5 optional steps. If they have not completed any yet, only the required quantity to earn is displayed, labeled "Step not earned".
Optional subgroup without a minimum requirement
If there is no minimum requirement, the subgroup only appears once the person has earned at least one optional step from it.
Progress toward the final credential
The accordion clearly shows the steps already completed and exactly how many remain. When all requirements are met, the final credential is awarded automatically.
Learning Paths via API
POK provides a public API to automate learning path workflows.
Issue steps via API
First, get the identifiers you need:
- Learning Path ID
- Step ID
Use the List learning routes endpoint.
The response includes the existing learning paths, all the steps associated with each path, and the identifiers to use in issuances.
Then issue a step assigned to a learning path following the official documentation for the Emit credential endpoint.
Include in the request:
- Path ID
- Step ID
- Recipient data
- Credential data
Monitor progress via API
To check a person's progress in a learning path programmatically, use the Get progress endpoint.
The response tells you:
- Whether the path has been completed
- Which steps have already been earned
- The person's current progress status
View learning path issuances
From the Awards section you can monitor all the activity on your paths.
The Awards section includes cascading filters:
- Path Name: filter by a specific path
- Module: choose the module within the path
- Step: select the specific step within the module
With these filters you can view all the credentials issued within a specific path, track each person's progress through the steps, and identify which steps have already been awarded.
Questions?
If you have any questions or run into issues, contact us at contact@pok.tech.
Learn more
Learn how learning paths help you structure multi-step credentialing programs on the learning paths feature page.