Publishing a Form

The Publishing Lifecycle

Version History

Every publish creates a new version entry in the form's history. You can view all previous versions in the History tab of the designer. Each version entry shows:

• Version number (1, 2, 3...)
• Published date and time
• Published by (user name)
• Change summary (optional note entered at publish time)
• Schema snapshot (click to view the schema at that version)

Updating a Published Form

You cannot directly edit a published form. To make changes:

1. Click Create New Version on the published form
2. This creates a Draft copy of the current schema
3. Make your edits in the designer
4. Submit for Review and Publish as normal
5. The new published version replaces the old one
6. The old version remains in history (accessible for rollback)

Rollback

If a newly published form has an issue, you can rollback to a previous version:

1. Open the form's History tab
2. Click Restore on any previous version
3. This creates a new Draft from the historical schema
4. Review and publish as a new version

Archive vs Delete

Forms are never permanently deleted via the Studio UI. Archiving is the end-of-life action:

Publish API Call

Publishing is a status update on the form record:

// Update form status to published
await apiClient.updateForm(formId, {
  ...currentDefinition,
  metadata: {
    ...currentDefinition.metadata,
    status: 'published',
    publishedAt: new Date().toISOString(),
    publishedBy: currentUser.id
  }
});