Learning paths
Learning paths are curated sequences of existing content. They appear at /learning-paths/[slug] and can include a certification assessment and optional one-time purchase price.
Admin path
/admin/learning-paths → New path → /admin/learning-paths/new
Certification assessment: /admin/learning-paths/[id]/assessment
Prerequisites
Build the path after the content it references exists:
- Publish articles, frameworks, resources, podcasts, etc.
- Copy each item's database ID from its CMS edit URL
- Add items to the path in the desired order
See Overview — Finding content IDs.
Path fields
| Field | Purpose |
|---|---|
| Title / Slug | Path name and URL |
| Description | Overview and default teaser |
| Difficulty | Foundational, Intermediate, or Advanced |
| Estimated duration (minutes) | e.g. 90 for 1h 30m |
| Visibility / Teaser | See Access & gating |
| One-time price (USD) | Whole dollars — leave blank to disable individual purchase |
| Content items | Ordered list of type + ID pairs |
| Published | Live on public site |
Content item types
Each row is a content type + content ID:
| Type | ID from |
|---|---|
| Article | /admin/articles/[id] |
| Framework | /admin/frameworks/[id] |
| Lab report | /admin/articles/[id] (type LAB_REPORT) |
| Resource | /admin/resources/[id] |
| Podcast episode | /admin/podcasts/[id] |
| Research note / Experiment / Working paper / Study summary | /admin/articles/[id] |
The form hint: "Enter the database ID for each piece of content. You can find IDs in the URL when editing that item in the CMS."
Step-by-step: create a path
- Publish all content items first; note their IDs
/admin/learning-paths/new- Title, description, difficulty, duration
- Set Visibility (Premium paths require subscription or purchase)
- Optional: set One-time price (e.g.
49for $49) — requires Commerce setup - Add content rows in order (type + ID for each)
- Check Published
- Save → verify at
/learning-paths/[slug]
Access rules
A member can access a path if either:
- Their plan meets the path's visibility level (via
canAccess), or - They purchased the path individually (when a price is set)
Premium subscribers can access Premium-gated paths without buying individually.
Certification assessment
Each path can have one certification quiz attached at:
/admin/learning-paths/[id]/assessment
Link from the path edit page or navigate directly after saving the path.
Assessment fields
| Field | Purpose |
|---|---|
| Title / Description | Assessment header |
| Passing score (%) | Default 80 — user needs ≥ this percentage |
| Time limit (min) | Blank = no limit |
| Max attempts | Default 3; 0 = unlimited |
| Shuffle questions / options | Randomize order |
| Questions | Multiple choice, multi-select, or true/false |
| Published | Visible to members who have path access |
Question types
| Type | Behavior |
|---|---|
| Multiple choice | One correct answer |
| Multi-select | One or more correct answers |
| True / False | Fixed True/False options |
Each question has points, optional explanation (shown after submission), and marked correct options.
Member experience
Members with path access see the certification on the path detail page. Passing records a certification on /account.
Pricing vs visibility
| Setting | Effect |
|---|---|
| Visibility = Premium, price blank | Premium subscribers only |
| Visibility = Premium, price = 49 | Premium subscribers or anyone who pays $49 once |
| Visibility = Public, price = 49 | Everyone sees listing; full access after purchase or if plan covers it |
Configure Stripe before enabling paid paths — see Commerce setup.
Tips
- Keep a spreadsheet: content title → CMS URL → ID → path order
- Re-order items in the form before saving (order is persisted on save)
- Add certification after path content is stable
- Test the full member journey: enroll → complete items → take assessment → check
/account