For the complete documentation index, see llms.txt. This page is also available as Markdown.

Versioning

Once a workflow is live and used daily, updating it directly can be challenging because changes to form items or triggers apply immediately to shop floor operations. Enabling controlled versioning protects live templates from accidental modifications, maintains operational stability, and keeps an audit history of changes. Besides, having a controlled versioning becomes a good practice in order to manage the changes and evolution of the business.

Once Version control is enabled for a template, this action cannot be undone.

This optional feature protects live templates from accidental changes while providing a history of activity template changes. This feature is configured per activity template and turning this on can not be reversed.

Confirmation modal overlaying an activity template configuration screen, asking "Do you want to continue?" with a message stating that converting an untracked template to a tracked template cannot be undone

How to Enable Versioning

On the target Activity Template.

1

Click Edit Template in the upper menu.

Header bar of an activity template screen highlighting the "Edit template" button
2

Select Enable version control.

Template configuration sidebar highlighting the "Enable version control" button
3

In the confirmation dialog ("Do you want to continue?"), click Yes to confirm.

Confirmation modal overlaying an activity template configuration screen, asking "Do you want to continue?" with a message stating that converting an untracked template to a tracked template cannot be undone

The current configuration is locked as Version 0 with the status Live. This version cannot be edited directly and a new version might be created to modify the template.

Manage and Publish new versions

1

On the Live version Edit template page, click Create new version.

Action bar for a live template displaying the status tag "Version 0 Live" and a highlighted "Create new version" button
2

This creates Version 1 with the status Draft, which is open for editing.

Activity template interface in draft mode showing form fields on the left, a "Draft" banner, and side options
3

Make the necessary changes to the form, fields, or properties (draft edits will not affect operators on the shop floor). And once finalized, click Promote to set its status as LIVE.

Action bar for a draft template showing the status tag "Version 1 Draft" and highlighting the "Promote to Live" button
4

In the confirmation pop-up, optionally add Comments explaining the changes, and click Publish.

Pop-up dialog titled "Promote to live" containing a "Comments" text box and a blue "Publish" button

Now Version 1 becomes the active Live version, and Version 0 is automatically changed to Archived. All changes made on Version 1 are now visible to the operators.

Action bar showing the status tag updated to Live in "Version 1"
Action bar showing the status tag updated to Archived in "Version 0"

Subsequent Updates: To make further changes, repeat the process by clicking Create new version on the current Live template to generate a new draft (e.g., Version 2).

Template Status Reference

Status
Description
Editable?
Visible to Operators?

LIVE

The active version currently used in daily shop floor operations. Only one version can be Live at a time.

No

Yes

DRAFT

A working copy created for making changes or updates. Changes made here do not affect live operations.

Yes

No

ARCHIVED

A historical, read-only snapshot of a previous Live version that has been superseded by a newer version.

No

No

Viewing All Versions

Version History section

Under the Version History section in the template you can select previous versions to view what they were.

Template configuration side panel with the "Version History" accordion expanded, displaying a list of template versions

Viewing archived templates provide a snapshot into the history of the Activity Template. Here they cannot be edited but can be restored to a draft version by selecting the Restore to drafts button.

Activity Template list

In the Activity Templates list, open Filters > More filters, select Status, and check DRAFT, LIVE, and ARCHIVED to display the complete version history.

Filter dropdown menu showing options to filter templates by status, with "DRAFT", "LIVE", and "ARCHIVED" selected
Activity Template list table showing all versions of the activity template used on the example

Last updated