This page is for a Developer who builds a course that a CampaignA developer's data-production project and its settings will require, or who grades the written answers learners submit to it. Any member of the organizationThe Developer-side unit that holds Campaigns, data access, and funds that owns the course can do both: Owner, Admin, or Member. Membership is the only requirement.
In the Developer portal sidebar, select Academy. It opens Academy Programs, the list of courses in your active organization. Authoring and grading both start here, and neither needs a Campaign to exist first.
If Academy is locked, or the page says the account is not in an organization, create or join an organization first. If the page says You don't have permission to view this, ask an Owner or Admin of that organization to invite you.
Create the course and its first version
Select New Program. Enter a Title, which is required, and a Description that says who must take the course and why. Then select Create Program.
The course editor opens with no version yet. Select Create Version 1. Every lesson you add belongs to this draft version.
To return to a course later, open it from Academy Programs. A course that has never been published offers Edit Course. A published course offers Publish New Version, which opens a draft copied from the latest published version and leaves the published one as it is.
If Create Program returns an error, look for the course in the list before trying again, so you do not create it twice.
Add lessons
In the editor, Add lesson offers three lesson types. Each lesson you add is a required step: a learner finishes the course only after completing every lesson in the version.
| Lesson | What you prepare | How a learner completes it |
|---|---|---|
| Reading | Lesson name and an Article in Markdown, checked with Preview | Selects Mark as read after reading |
| Video | Lesson name, Lesson description, and a YouTube URL | Selects Mark as watched after watching |
| Quiz | Lesson name, at least one question, and Pass threshold (%) | Scores at or above the pass threshold |
A Reading can carry one attached image or PDF in place of the article. A Video can carry an uploaded MP4 or WebM file in place of the YouTube URL. In both cases the file replaces the other source, so the learner sees only the file.
Write quiz questions
Open the Quiz lesson and select Add question. The new question arrives already filled in, with placeholder text, one correct choice, and one wrong choice. Overwrite them with your own. A question saves on its own each time you leave one of its fields.
Every question has a Question text, a Question type, and Points from 1 to 100. The type decides what else you provide and how the answer is graded.
| Question type | What you provide | How it is graded |
|---|---|---|
| Single choice | 2 to 6 Choices, exactly one marked Correct | Automatically. Correct when the learner picks that choice |
| Multiple choice | 2 to 6 Choices, at least one marked Correct | Automatically. Correct only when the learner selects every correct choice and no other |
| Fill in the blank | 1 to 6 Accepted answers, each one different | Automatically. The typed answer must equal one accepted answer; capitalization and surrounding spaces are ignored |
| Open answer | Nothing more; it has no answer key | By hand. The learner has no quiz score until a grader has marked every open answer in the attempt |
While a question breaks its rule, a warning appears under it and its answers are not saved. A choice question with no Correct choice, for example, shows Mark the correct answer — as written, nobody can pass this question.
Set the pass threshold
The quiz score is the points a learner earned as a percentage of the quiz's total points. A question earns all of its points or none. Pass threshold (%) is the lowest score that passes; it starts at 70 and accepts whole numbers from 1 to 100. Learners can retry a quiz as often as they need.
Keep the threshold at 70 or above. The course result requires at least 70% on every quiz whatever the quiz's own threshold, so a lower threshold lets a learner pass the quiz without finishing the course.
Example: a small course that can be published
This illustration has one Reading and one Quiz. It clears the submissionThe record created when work is submitted check, and because its only question is graded automatically, learners get their result without waiting for a grader.
| Lesson | Field | Example value |
|---|---|---|
| Reading | Lesson name | Labeling standard |
| Reading | Article | The standard the quiz tests, with one worked example |
| Quiz | Lesson name | Qualification quiz |
| Quiz | Question | Which label applies to a receipt whose total cannot be read? |
| Quiz | Question type | Single choice |
| Quiz | Points | 1 |
| Quiz | Choices | A: Unreadable, marked Correct. B: Valid |
| Quiz | Pass threshold (%) | 70 |
With a single one-point question, a learner scores either 100% or 0%.
Save, submit, and follow the review
Save as Draft saves your lesson edits and shows Saved as draft.
When every lesson is complete, select Submit for Review. The dialog checks the version first. An unfinished lesson is listed with Fix →, and the submit button stays disabled until you finish it: a Reading needs an article or an attachment, a Video needs a URL or a file, and a Quiz needs at least one question with a valid answer set.
Confirm with Submit for Review in the dialog. The page shows Submitted for review — an Academy admin will approve or reject this version. The Academy admin is a Humanbased reviewer, not an Admin of your organization.
Follow the result on the course page, beside Status.
| Status | What it means | What to do now |
|---|---|---|
| Draft | The version is editable. Learners cannot take it and a Campaign cannot require it | Finish the lessons, then submit for review |
| In review | The version is submitted and locked, waiting for the Academy admin | Wait for the decision. Lessons and questions cannot be edited meanwhile |
| Changes requested | The reviewer returned the version to draft and left Reviewer feedback on the course page | Open the editor, make the changes, and submit for review again |
| Published | The version is approved. Learners can take it and a Campaign can require it | Bind it in the Campaign's Entry Gate |
Bind the course to a Campaign
A published course affects a Campaign only when that Campaign's Entry GateThe workflow step that holds a Campaign's joining requirements requires it. Open the Campaign, select Open builder, and select the Entry Gate node. Its panel has three course fields.
| Field | What to choose |
|---|---|
| Required course | The course. Only published courses are listed |
| Course version | The published version to require. Choosing a course selects its latest published version |
| What counts as done | Has finished the course, which is the default |
Has finished the course is met when the learner has completed every lesson: each Reading and Video marked done, and each Quiz passed. A learner who passed an earlier version of the same course still meets it; see version rules.
Leave Has mastered the course unselected for a course built here. That option asks for a mastered result, while completing a course records a passed result. No lesson or quiz setting in the editor produces a mastered one, so no learner could open the Gate.
The requirement stays on the version you chose. After you publish a newer version, this panel offers a button named for it, such as Require v2; select it to move the Campaign to that version. Save the panel and then the canvas as described under Entry Gate.
Grade open answers
A quiz with an Open answer question is finished by a grader. Each learner's attempt waits, and the learner sees Submitted — awaiting grading, until every open answer in it has a grade.
On Academy Programs, select Review. This queue holds learners' answers. It is separate from Submit for Review in the course editor, which sends a course version to the Academy admin.
The queue lists every open answer waiting in the active organization, across all of its courses, oldest first. Any member of that organization can grade them. Each answer is a card with everything you need on it.
| Part of the card | What it shows |
|---|---|
| Top line | The course name and the Quiz lesson name. Select it to open the course and reread the lesson the question tests |
| Second line | The question, its points, and when the learner submitted |
| Shaded box | The learner's answer, or (no answer text) when the answer is empty |
| Buttons | Mark correct and Mark incorrect |
Read the question and the answer, then select one of the two buttons. Mark correct gives the answer all of the question's points, and Mark incorrect gives it none.
Decide before you select: the queue lists only ungraded answers, so a recorded decision cannot be reopened from this page.
Both buttons are disabled while the decision is sent. When it is recorded, the card leaves the queue; that disappearance is the confirmation.
Once the last open answer in a learner's attempt is graded, the quiz gets its score and its pass or fail, and the learner's course result is updated.
| What you see | What it means | What to do now |
|---|---|---|
| The card disappears after you select a button | The decision was recorded | Go on to the next card |
| An error message appears and the card stays | The request returned an error, so the outcome is not confirmed | Reload the page. If the card is still listed, it has no grade yet, so decide again. If it is gone, the decision was recorded |
| Nothing to grade right now | No open answer in the active organization is waiting. A course version's review shows on the course page, beside Status | Come back after learners submit. Check the active organization if you expected answers |
| The review queue could not be loaded. Please try again. | The list request failed | Reload the page |
| You don't have permission to view this | Your account is not a member of the active organization | Ask an Owner or Admin of that organization to invite you |