Editing & Publishing
Every page in the lab editor (Details, Dynamic Values, Sandbox, Activities, Tabs, Layouts, Files) shares the same save lifecycle, covered here once so you know what to expect no matter which page you’re working on.
Read-only and Edit mode
Section titled “Read-only and Edit mode”A lab you open normally starts read-only. In this state the top bar shows a Read-only label and a small set of actions: Project settings, Change history, Logs, a Share button, and Play. Nothing on the page can be changed.
Click Edit mode to start making changes. Editing a freshly created or imported lab drops you into edit mode automatically, so you don’t need to click it yourself right after creating a lab.
Adding changes on a page
Section titled “Adding changes on a page”While in edit mode, each page you edit (Details, a container, a task, and so on) has its own Discard changes / Add changes buttons, which appear at the bottom of the page once you’ve changed something.
- Add changes saves your edits on that page to the current editing session. It does not publish anything yet.
- Discard changes reverts that one page back to its last saved state.
You can move between pages and use Add changes on as many resources as you like before publishing anything.
Review changes
Section titled “Review changes”Open Review changes from the More actions menu (the ⋮ icon next to Publish) to see everything you’ve added in the current session as a file-level diff: additions in green, deletions in red, one block per changed file. This page is read-only: it’s for reviewing what you’re about to publish, not for saving or discarding individual files. Use Back to edit mode to return and keep editing.
If you haven’t changed anything yet, this page shows an empty state instead of a diff.
Publishing
Section titled “Publishing”Click Publish in the top bar to open the Save changes dialog. This is the action that actually applies everything you’ve added with Add changes:
| Field | Description |
|---|---|
| Save to this branch / Save to new branch… | Choose whether to commit directly to the branch you’re currently viewing, or create a new branch for these changes. Picking a new branch reveals a Branch name field. |
| Changes title | Required. Becomes the commit message title (72 characters max). |
| Changes description | Optional. Becomes the extended commit message. |
Publish is disabled until you’ve used Add changes on at least one page. Submitting the dialog commits everything you’ve added as a single commit, ends your editing session, and switches you to the branch you just published to. Published commits show up immediately in Change History.
Sharing your lab
Section titled “Sharing your lab”Once a lab is ready, use the Share button in the top bar to make it available to learners. It opens a menu with two ways to share:
- Simple embed: embed the lab in an external web page.
- LTI integration: make the lab available through an LMS that supports LTI.
Discarding an entire session
Section titled “Discarding an entire session”The More actions menu also has an entry for leaving edit mode entirely, without publishing. Its label and behavior depend on whether you have unpublished changes:
- If you haven’t used Add changes on anything yet, the entry reads Exit edit mode. Clicking it exits edit mode immediately, no confirmation needed since there’s nothing to lose.
- If you have unpublished changes, the entry reads Discard changes. Clicking it opens a confirmation dialog warning that discarding will permanently remove all changes made in the session. Confirming throws away everything you’ve added in the current editing session (not just one page) and exits edit mode.
Summary
Section titled “Summary”- Add changes / Discard changes on a page saves or reverts your edits on that page only.
- Review changes shows everything added in the session as a diff, read-only.
- Publish commits everything you’ve added at once, to the current branch or a new one.
- The session-level entry in More actions exits edit mode: it reads Exit edit mode and needs no confirmation when there’s nothing to lose, or Discard changes with a confirmation dialog when there are unpublished changes.