Study versions and checkpoints
FromUsers versions study form content as Checkpoints. Use them to review AI proposals, keep a history of accepted edits, and restore an earlier form when needed.
How versioning works
Section titled “How versioning works”| Concept | Meaning |
|---|---|
| Active checkpoint | The current working form draft |
| Inactive checkpoints | Prior snapshots or unresolved AI proposals |
| Revision kinds | Labels such as AI proposal, with edits, accepted changes, accepted reviewed |
Only one form version is active at a time.
Review an AI proposal
Section titled “Review an AI proposal”When generation or AI edits create a proposal, the review header shows the version and how many items changed. You can:
| Action | Result |
|---|---|
| Accept all changes | Take the full proposal |
| Apply reviewed only | Keep only items you already accepted |
| Discard all | Leave the study unchanged (toast confirms the proposal was discarded) |
| Per item Accept these changes | Confirm that item |
| Per item Keep previous version | Reject that item’s proposal (including confirming removals when relevant) |
Finish review before you rely on Preview as the source of truth for what participants will see.
Restore a checkpoint
Section titled “Restore a checkpoint”- Open the Checkpoints menu in the form editor.
- Find a non-active resolved Checkpoint in the list (the current one is marked).
- Choose Restore.
- Confirm that later changes will be removed.
Success feedback looks like “Checkpoint restored.”
When to restore vs edit forward
Section titled “When to restore vs edit forward”| Situation | Prefer |
|---|---|
| AI draft went in the wrong direction | Discard proposal or restore prior checkpoint |
| Small mistake after manual edits | Edit forward on the active draft |
| Need a known-good structure from yesterday | Restore that checkpoint, then continue |
- Restore carefully on shared studies; coordinate with collaborators first.
- After restore, re-check logic, translations, and prototype bindings.
- Accepting AI changes still deserves a human pass on sensitive screener and consent copy.
Common questions
What is a checkpoint?
A checkpoint is a saved form version. Exactly one version is the active working draft. Earlier resolved checkpoints can be restored.
What happens if I restore an old checkpoint?
Restoring reverts the form to that checkpoint and removes later changes. Confirm the warning before you proceed.
How do AI proposals relate to versions?
AI drafts can appear as proposals with per-item keep or accept actions, plus Accept all, Apply reviewed only, or Discard all.