> For the complete documentation index, see [llms.txt](https://help.tillit.cloud/tillit/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.tillit.cloud/tillit/knowledge-base/setting-up-tillit/activity-templates/activity/versioning.md).

# 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.

{% hint style="info" %}
**Once Version control is enabled for a template, this action cannot be undone.**
{% endhint %}

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.

<figure><img src="https://s3.amazonaws.com/helpscout.net/docs/assets/60208fd212248b2c96d50eeb/images/631eafd7c713d51da3edd7a7/file-GJQmtxwhOw.png" alt="Confirmation modal overlaying an activity template configuration screen, asking &#x22;Do you want to continue?&#x22; with a message stating that converting an untracked template to a tracked template cannot be undone"><figcaption></figcaption></figure>

## How to Enable Versioning

On the target Activity Template.

{% stepper %}
{% step %}
Click **Edit Template** in the upper menu.

<figure><img src="/files/ZpGIFjia43Ti4q3KHyRb" alt="Header bar of an activity template screen highlighting the &#x22;Edit template&#x22; button" width="333"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Select **Enable version control**.

<figure><img src="/files/1ANbx2YLL1vMALev9gcl" alt="Template configuration sidebar highlighting the &#x22;Enable version control&#x22; button" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
In the confirmation dialog (*"Do you want to continue?"*), click Yes to confirm.

<figure><img src="/files/iHQzzmA6u6nvSgeoSVNF" alt="Confirmation modal overlaying an activity template configuration screen, asking &#x22;Do you want to continue?&#x22; with a message stating that converting an untracked template to a tracked template cannot be undone" width="257"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

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

{% stepper %}
{% step %}
On the Live version Edit template page, click **Create new version**.

<figure><img src="/files/eUuAKAxRPM0d8W6a7s6O" alt="Action bar for a live template displaying the status tag &#x22;Version 0 Live&#x22; and a highlighted &#x22;Create new version&#x22; button" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
This creates Version 1 with the status Draft, which is open for editing.

<figure><img src="/files/k3l4ea0xQZwJqa5bHmal" alt="Activity template interface in draft mode showing form fields on the left, a &#x22;Draft&#x22; banner, and side options" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
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.

<figure><img src="/files/feasU1DBIo0rp49SXMbT" alt="Action bar for a draft template showing the status tag &#x22;Version 1 Draft&#x22; and highlighting the &#x22;Promote to Live&#x22; button" width="375"><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="/files/Jt8hR9TZVq66JZh98fQw" alt="Pop-up dialog titled &#x22;Promote to live&#x22; containing a &#x22;Comments&#x22; text box and a blue &#x22;Publish&#x22; button" width="308"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

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.

<figure><img src="/files/INNyatDJbOUwRLWrYMT5" alt="Action bar showing the status tag updated to Live in &#x22;Version 1&#x22;"><figcaption></figcaption></figure>

<figure><img src="/files/n9U2dPnkRGoUzJsLze4N" alt="Action bar showing the status tag updated to Archived in &#x22;Version 0&#x22;"><figcaption></figcaption></figure>

{% hint style="info" %}
**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).
{% endhint %}

### 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.

<figure><img src="/files/cDYSLdVyKrQqztMN3425" alt="Template configuration side panel with the &#x22;Version History&#x22; accordion expanded, displaying a list of template versions" width="371"><figcaption></figcaption></figure>

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.

<figure><img src="/files/WSdcwpm29njf0jUhwsdI" alt="Filter dropdown menu showing options to filter templates by status, with &#x22;DRAFT&#x22;, &#x22;LIVE&#x22;, and &#x22;ARCHIVED&#x22; selected"><figcaption></figcaption></figure>

<figure><img src="/files/E62CbHsTuCcqlQlyXgTb" alt="Activity Template list table showing all versions of the activity template used on the example"><figcaption></figcaption></figure>