Author Content: Mandatory blocks (Beta)
Overview
Mandatory blocks let authors decide exactly what a learner needs to do before an Author Content item counts as complete. Rather than relying on a learner to click Mark complete whenever they feel ready, you can mark specific blocks — a checklist, a set of tabs, a video and more — as required. Once a learner has worked through every required block, the item completes automatically, with no extra click needed.
This is useful anywhere you want to be confident a learner has genuinely engaged with the content, not just skimmed past it — onboarding checklists, compliance walkthroughs, or any item where "read to the bottom" isn't quite enough proof of completion.
This feature is currently in Open Beta — enable or disable it at any time from Company Settings → Beta Features. Items that don't use any required blocks carry on working exactly as before, so turning this on is entirely safe for your existing content.
How It Works
For authors
When editing an Author Content item, selecting a block opens the Options panel on the right-hand side. With this beta enabled, supported blocks show a Require completion checkbox. Tick it, save the item as normal, and that block now forms part of what a learner must complete.
You can mark as many or as few blocks as required as you like. If you don't mark any blocks as required, the item keeps its ordinary manual Mark complete button — nothing changes for it.
Not every block supports this. The table below shows which ones do, and what "completing" that block actually means for a learner:
Block | One step is... | A learner completes it by... |
|---|---|---|
Checklist | each checklist item | ticking the box |
Accordion | each section | opening the section |
Tabs | each tab | clicking the tab (even the one that's open by default still needs a click to count) |
Downloads | each file | downloading the file |
Interactive reveal | each card | revealing the card |
Modal reveal | each trigger | opening it |
Hotspots | each pin | clicking the pin |
Video | the whole block | watching it |
Audio / voicenote | the whole block | listening to it |
💡 A required block that's empty — for example, an accordion with no sections added yet — simply contributes no steps. It can never lock a learner out of completing the item.
For learners
Learners see a progress banner at the top of the item, showing something like "3 of 5 steps complete". It's grey while the learner is still working through the content, and turns green with a tick once everything is done.
The Mark complete button is replaced with "Completes automatically" — it isn't clickable, because completion is handled for the learner as they go. If someone tries to force completion early, they'll see the message "Complete every required block before marking this item complete."
As a learner ticks a checklist item, opens a tab, downloads a file and so on, their progress saves in real time. Once the final required step is done, the item completes automatically — celebration and all, just like any other completion.
A couple of things worth knowing:
Progress is sticky. Once a learner has completed the item, nothing an author does afterwards — including adding more required blocks — will un-complete it for that learner.
Progress adjusts if content changes. If an author removes a required block after learners have already started, everyone's step count adjusts automatically so it stays accurate.
Progress is per learner and per item. One learner's progress on an item never affects another's.
⚠️ Translations are tracked separately. Required steps are tracked against the specific language version a learner is viewing. If required blocks only exist in one language version of an item, learners viewing a different language version won't need to complete them before the item finishes.
Completion feeds into the same completion record as any other item, so learnlist progress, tasks, certificates, channel progress and reporting all behave exactly as they always have. There's no separate report of per-step progress — only the learner themselves sees how far through the required steps they are.
Prerequisites
Author Content is available to all customers, so you don't need anything extra to start creating items. Mandatory blocks is the part currently in Open Beta, and needs switching on separately from Company Settings → Beta Features.
Role Requirements
Marking a block as required uses the same permissions as editing the item itself — there's no separate role to manage:
Owner, Admin and Learning Designer roles can mark blocks as required on any Author Content item
Curators can do the same on any item they already have permission to edit
Turning the beta itself on or off is managed by Owners and Admins from Company Settings → Beta Features
Any learner who can view the item can work through its required steps and trigger automatic completion — no special role needed
Quick Start Guide
From Company Settings → Beta Features, switch on the Mandatory blocks beta
From the sidebar, create a new Author Content item (Add new → Item → Author Content) or open an existing one in edit mode
Select the block you want learners to complete — for example, a checklist or a video
In the Options panel on the right, tick Require completion
Repeat for any other blocks you want to make mandatory
Save the item as usual
Preview or publish it — learners will now see the progress banner and complete the item automatically once every required step is done
FAQs
Q: Does ticking a checklist item complete the item?
It can — if that checklist is set to require completion and it's the last required step remaining, ticking it will complete the item automatically.
Q: What happens to items with no required blocks?
Nothing changes. They keep the ordinary manual Mark complete button.
Q: Can a learner be un-completed if I add more required blocks later?
No. Completion is sticky — once a learner has completed the item, later changes never take that completion away.
Q: Do learners see which steps are left?
The progress banner shows how many steps are complete out of the total (for example, "3 of 5 steps complete"), and each required block shows its own completed state in place as the learner works through it.
Q: What if I delete a required block after learners have already started?
Their progress adjusts automatically so the step count stays correct — nobody gets stuck because a block they'd already completed disappeared.
Q: Is there a report showing per-step progress?
Not at this time. Completion reporting works exactly as it does for any other item — at the item level. Learners can see their own step-by-step progress on the item itself.
Troubleshooting
Issue | Solution |
|---|---|
Can't see the Require completion checkbox in the Options panel | Confirm the Mandatory blocks beta is switched on in Company Settings → Beta Features, and check the selected block type supports it — see the table in How It Works. |
Item isn't completing even though the learner has done everything visible | Check whether an accordion, tabs or reveal block has a section, tab or card the learner hasn't yet opened or clicked — each one counts as its own step. |
Mark complete button won't do anything | This is expected once an item has required blocks — completion happens automatically once every step is finished, so the button shows "Completes automatically" instead. |
Learner sees "Complete every required block before marking this item complete." | The learner hasn't finished every required step yet. Check the progress banner to see how many steps remain. |
A learner in a different language isn't required to complete blocks | Required steps are tracked per language version. If the required blocks only exist in one language version of the item, other language versions won't include them. |