{"id":8590,"date":"2025-05-08T08:00:24","date_gmt":"2025-05-08T08:00:24","guid":{"rendered":"https:\/\/www.process.st\/help\/?post_type=ht_kb&#038;p=8590"},"modified":"2026-11-03T14:41:13","modified_gmt":"2026-11-03T14:41:13","slug":"version-control","status":"publish","type":"ht_kb","link":"https:\/\/www.process.st\/help\/docs\/version-control\/","title":{"rendered":"Version Control &#038; Audit History"},"content":{"rendered":"<p>Version Control and audit history logs allow you to systematically track document changes, maintain comprehensive version history, and ensure compliance with regulatory standards, such as ISO 9001.<\/p>\n<p>You can maintain detailed, immutable records of who made changes and when actions occurred. You can then easily export or share those records with external stakeholders or auditors.<\/p>\n<p><em><strong><i>Users: You must be an Administrator to enable Version Control.<\/i><\/strong><\/em><\/p>\n<p><em><strong><i>Please <a href=\"https:\/\/www.process.st\/help\/docs\/support\/\" target=\"_blank\" rel=\"noopener\">contact our support team<\/a> if you would like to trial this feature.<\/i><\/strong><\/em><\/p>\n<h2>How to enable version control<\/h2>\n<p>Version control can be enabled by an Admin from the <a href=\"https:\/\/brightstar.process.st\/organizations\/manage\/settings\" target=\"_blank\" rel=\"noopener\">organization settings page<\/a>.<\/p>\n<p>This lets you track version numbers and history on Workflows, <a href=\"https:\/\/www.process.st\/help\/docs\/pages\/\" target=\"_blank\" rel=\"noopener\">Pages<\/a>, <a href=\"https:\/\/www.process.st\/help\/docs\/document-management\/\" target=\"_blank\" rel=\"noopener\">Files<\/a> and <a href=\"https:\/\/www.process.st\/help\/docs\/forms\/\" target=\"_blank\" rel=\"noopener\">Forms<\/a>.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-full wp-image-8677\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Enable-version-control-scaled.png\" alt=\"How to enable versioning\" width=\"100%\" srcset=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Enable-version-control-scaled.png 2560w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Enable-version-control-300x150.png 300w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Enable-version-control-1024x512.png 1024w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Enable-version-control-768x384.png 768w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Enable-version-control-1536x768.png 1536w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Enable-version-control-2048x1024.png 2048w\" sizes=\"(max-width: 2560px) 100vw, 2560px\" \/><\/p>\n<p>&nbsp;<\/p>\n<h2>Material and non-material changes<\/h2>\n<p>You can choose between material and non-material changes when publishing updates to Workflows, <a href=\"https:\/\/www.process.st\/help\/docs\/pages\/\" target=\"_blank\" rel=\"noopener\">Pages<\/a>, <a href=\"https:\/\/www.process.st\/help\/docs\/document-management\/\" target=\"_blank\" rel=\"noopener\">Files<\/a> and <a href=\"https:\/\/www.process.st\/help\/docs\/forms\/\" target=\"_blank\" rel=\"noopener\">Forms<\/a>.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-full wp-image-8678\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Publish-and-select-type-of-change-scaled.png\" alt=\"Select material or non material change\" width=\"100%\" srcset=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Publish-and-select-type-of-change-scaled.png 2560w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Publish-and-select-type-of-change-300x150.png 300w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Publish-and-select-type-of-change-1024x512.png 1024w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Publish-and-select-type-of-change-768x384.png 768w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Publish-and-select-type-of-change-1536x768.png 1536w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Publish-and-select-type-of-change-2048x1024.png 2048w\" sizes=\"(max-width: 2560px) 100vw, 2560px\" \/><\/p>\n<p>The explanation of changes is mandatory since it will be added to the revision history table (more on this below).<\/p>\n<p>Material changes will increase the version number by 1, and non-material changes will increment it by 0.1.<\/p>\n<h2>Reference ID<\/h2>\n<p>You can add reference Ids to the names of any Workflows, Pages, Files or Forms in your organization.<\/p>\n<p>Click the <strong>settings cog<\/strong> when you&#8217;re in edit mode, and you can set the reference ID.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-full wp-image-8713\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/05\/Ref-ID-1-scaled.png\" alt=\"How to add reference ID to documents\" width=\"100%\" srcset=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/05\/Ref-ID-1-scaled.png 2560w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/05\/Ref-ID-1-300x150.png 300w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/05\/Ref-ID-1-1024x512.png 1024w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/05\/Ref-ID-1-768x384.png 768w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/05\/Ref-ID-1-1536x768.png 1536w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/05\/Ref-ID-1-2048x1024.png 2048w\" sizes=\"(max-width: 2560px) 100vw, 2560px\" \/><\/p>\n<p>Reference IDs will show with the version number in your Library (shown below), in <a href=\"https:\/\/www.process.st\/help\/docs\/reports\/\" target=\"_blank\" rel=\"noopener\">Reports<\/a> (when you select the version columns) and in the editor focus bar.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-full wp-image-8683\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Version-and-Prefix-in-Library-scaled.png\" alt=\"Viewing prefix in your Library \" width=\"2560\" height=\"1280\" srcset=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Version-and-Prefix-in-Library-scaled.png 2560w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Version-and-Prefix-in-Library-300x150.png 300w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Version-and-Prefix-in-Library-1024x512.png 1024w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Version-and-Prefix-in-Library-768x384.png 768w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Version-and-Prefix-in-Library-1536x768.png 1536w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Version-and-Prefix-in-Library-2048x1024.png 2048w\" sizes=\"auto, (max-width: 2560px) 100vw, 2560px\" \/><\/p>\n<p><strong>Note<\/strong>: There&#8217;s a character limit of 100 characters on reference IDs.<\/p>\n<h2>Activity logs<\/h2>\n<p>Activity logs on Workflows, Files, Pages and Forms have a date range selector and an export function.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-full wp-image-8684\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Activity-log-filters-scaled.png\" alt=\"Filter and export activity logs\" width=\"100%\" srcset=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Activity-log-filters-scaled.png 2560w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Activity-log-filters-300x150.png 300w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Activity-log-filters-1024x512.png 1024w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Activity-log-filters-768x384.png 768w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Activity-log-filters-1536x768.png 1536w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Activity-log-filters-2048x1024.png 2048w\" sizes=\"(max-width: 2560px) 100vw, 2560px\" \/><\/p>\n<p>You can review up to one year at a time. For example, you can look at the last year or the year before, but not both of those years at the same time.<\/p>\n<p>Export your data as a CSV file using the button shown above.<\/p>\n<p><strong>Note:<\/strong> You can view activity logs on Completed Workflow runs.<\/p>\n<h2>Revision history tables<\/h2>\n<p>You can access revision history tables from the <strong>meatball menu<\/strong> on any Workflows, Files, Pages and Forms.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-full wp-image-8686\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Where-to-find-revision-history-scaled.png\" alt=\"Accessing revision history tables\" width=\"100%\" srcset=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Where-to-find-revision-history-scaled.png 2560w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Where-to-find-revision-history-300x150.png 300w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Where-to-find-revision-history-1024x512.png 1024w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Where-to-find-revision-history-768x384.png 768w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Where-to-find-revision-history-1536x768.png 1536w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Where-to-find-revision-history-2048x1024.png 2048w\" sizes=\"(max-width: 2560px) 100vw, 2560px\" \/><\/p>\n<p>The table shows the version number, prefix (if used), who made revisions, when and the description of changes.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-full wp-image-8687\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/View-and-export-revision-history-scaled.png\" alt=\"View and export a revision history table\" width=\"100%\" srcset=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/View-and-export-revision-history-scaled.png 2560w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/View-and-export-revision-history-300x150.png 300w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/View-and-export-revision-history-1024x512.png 1024w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/View-and-export-revision-history-768x384.png 768w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/View-and-export-revision-history-1536x768.png 1536w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/View-and-export-revision-history-2048x1024.png 2048w\" sizes=\"(max-width: 2560px) 100vw, 2560px\" \/><\/p>\n<p>For Workflows, Pages, and Files, you can restore to a previous version from this table. Export the details via CSV to share with an auditor.<\/p>\n<p><strong>Note:<\/strong> Forms do not have the Restore action in the Revision History table. You can still view, export, and compare Form revision history.<\/p>\n<p>For Files, each earlier published version in the Revision History table also has a <strong>View<\/strong> link (the current version doesn&#8217;t need one because it&#8217;s already displayed in the file viewer). Click a <strong>View<\/strong> link to open that version in the file viewer. A bar at the bottom of the viewer shows which version you are viewing and provides a <strong>View current version<\/strong> button to return to the latest version.<\/p>\n<p>When you print a document or workflow, or save it as a PDF, the history table is displayed in a table at the bottom of the document.<\/p>\n<h3>Compare revisions<\/h3>\n<p>For <a href=\"https:\/\/www.process.st\/help\/docs\/pages\/\" target=\"_blank\" rel=\"noopener\">Pages<\/a>, Workflows, <a href=\"https:\/\/www.process.st\/help\/docs\/forms\/\" target=\"_blank\" rel=\"noopener\">Forms<\/a> and <a href=\"https:\/\/www.process.st\/help\/docs\/document-management\/\" target=\"_blank\" rel=\"noopener\">Files<\/a>, you can compare revisions to see exactly what changed.<\/p>\n<p>In the Revision History table, a <strong>Compare<\/strong> link appears on every row except the current version. Click it to open an inline word-level diff that highlights the differences between that version and the current one. Use the <strong>From<\/strong> and <strong>To<\/strong> pickers in the comparison view to select any two published versions to compare.<\/p>\n<p>If a Page has an unpublished draft, the meatball (<strong>\u2026<\/strong>) menu in the editor shows a <strong>Compare with published<\/strong> option. This opens the same word-level diff view, so you can review your pending edits before publishing.<\/p>\n<p>When discarding a Page draft, the discard dialog shows how many changes will be lost (for example, &#8220;This draft has 5 changes since version 1.0&#8221;). Click <strong>View changes<\/strong> in the dialog to review what will be discarded before confirming.<\/p>\n<p>The comparison highlights the specific words that changed within each edited paragraph, rather than flagging entire blocks as different. Tables are compared row by row, making it easier to spot removed or changed content in table-heavy pages. Non-text content, including images, files, embeds, and workflow links, also appears in the comparison view.<\/p>\n<h4>Compare revisions (Workflows)<\/h4>\n<p>When a Workflow has an unpublished draft, the meatball (<strong>&#8230;<\/strong>) menu in the editor shows a <strong>Compare with published<\/strong> option. This opens a task-grouped comparison view. Changes are organized by task and include:<\/p>\n<ul>\n<li>Tasks added, removed, or renamed<\/li>\n<li>Renamed form fields and options, with before-and-after values<\/li>\n<li>Word-level text diffs for edited content<\/li>\n<li>Who last changed each task or field, and when<\/li>\n<li>Workflow settings changes, including the run name, due dates, assignments, task permissions, approvals, and AI tasks, code tasks, custom notifications, auto-sent emails, and data set actions, with before-and-after descriptions<\/li>\n<li>Conditional logic rule changes, shown rule by rule with human-readable descriptions of each rule&#8217;s conditions and targets, and word-level diffs highlighting what changed in edited rules<\/li>\n<\/ul>\n<p>The comparison loads fresh every time you open it, so it always reflects the latest edits.<\/p>\n<p>The conditional logic editor also has its own <strong>Compare with published<\/strong> button in the editor header. Click it to open a logic-only comparison view that shows only your conditional logic rule changes. If you have unsaved rule edits, the view notes that those changes are not yet reflected in the comparison.<\/p>\n<p>You can also compare versions from the Revision History table. Each published version except the current one has a <strong>Compare<\/strong> link. Click it to open a task-by-task comparison view with <strong>From<\/strong> and <strong>To<\/strong> pickers, so you can select any two published versions to compare.<\/p>\n<p><strong>Note:<\/strong> Comparing workflow versions requires edit access. The <strong>Compare<\/strong> column in the Revision History table is visible only to workflow editors. If you access Revision History as a reader (for example, from the Library row menu), the table does not include the <strong>Compare<\/strong> column.<\/p>\n<p>When discarding a draft, the discard dialog shows how many changes will be lost (for example, &#8220;This draft has 5 changes since version 1.0&#8221;). Click <strong>View changes<\/strong> in the dialog to review what will be discarded before confirming. This discard comparison also works for <a href=\"https:\/\/www.process.st\/help\/docs\/pages\/\" target=\"_blank\" rel=\"noopener\">Pages<\/a>.<\/p>\n<h4>What workflow comparison does not cover<\/h4>\n<p>Some items are not versioned and do not appear in the comparison at all. App integrations (such as HubSpot, Jira, and Airtable), webhooks (including Zapier, Make, and Power Automate), incoming webhooks, and scheduled runs are saved on the workflow and take effect immediately rather than when you publish. The workflow name and sharing settings are also not versioned.<\/p>\n<h4>Compare revisions (Forms)<\/h4>\n<p>When a Form has an unpublished draft, a <strong>Compare with published<\/strong> button appears in the form editor&#8217;s top bar. Click it to open a comparison view organized by step, showing which form fields changed and what differs.<\/p>\n<p>You can also open the comparison from the Revision History table. Access it via the <strong>Settings<\/strong> drawer in the form editor or from the Library row menu, then click the <strong>Compare<\/strong> link on any previous version.<\/p>\n<p>When discarding a draft, the discard dialog shows how many changes will be lost (for example, &#8220;This draft has 5 changes since version 1.0&#8221;). Click <strong>View changes<\/strong> in the dialog to review what will be discarded before confirming.<\/p>\n<h4>Compare revisions (Files)<\/h4>\n<p>When a <a href=\"https:\/\/www.process.st\/help\/docs\/document-management\/\" target=\"_blank\" rel=\"noopener\">File<\/a> has an unpublished draft, the meatball (<strong>&#8230;<\/strong>) menu in the file editor shows a <strong>Compare with published<\/strong> option. This opens a text-based comparison view that highlights word-level differences between the draft and the current published version.<\/p>\n<p>You can also compare versions from the Revision History table. Each published version except the current one has a <strong>Compare<\/strong> link. Click it to open the comparison view with <strong>From<\/strong> and <strong>To<\/strong> pickers, so you can select any two published versions to compare.<\/p>\n<p>When discarding a draft, the discard dialog shows how many changes will be lost (for example, &#8220;This draft has 5 changes since version 1.0&#8221;). Click <strong>View changes<\/strong> in the dialog to review what will be discarded before confirming.<\/p>\n<p>File comparison is text-based. When no text can be compared, the comparison view explains why:<\/p>\n<ul>\n<li><strong>No text available<\/strong>: the file is an image, audio, video, or another format that cannot be read as text, or text extraction has not finished yet.<\/li>\n<li><strong>Too long<\/strong>: the file contains more than 2,000,000 characters.<\/li>\n<li><strong>Too different<\/strong>: the two versions differ so much that the comparison timed out.<\/li>\n<li><strong>Same text<\/strong>: both versions contain identical text.<\/li>\n<\/ul>\n<h2>Webhooks<\/h2>\n<p>You can track material and non-material changes by setting up <a href=\"https:\/\/www.process.st\/help\/docs\/webhooks\/\" target=\"_blank\" rel=\"noopener\">webhooks<\/a> in your <a href=\"https:\/\/app.process.st\/organizations\/manage\/integrations\" target=\"_blank\" rel=\"noopener\">organization&#8217;s integrations area<\/a>.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-full wp-image-8652\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Version-tracking-webhook-scaled.png\" alt=\"Track changes with version control\" width=\"100%\" srcset=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Version-tracking-webhook-scaled.png 2560w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Version-tracking-webhook-300x150.png 300w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Version-tracking-webhook-1024x512.png 1024w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Version-tracking-webhook-768x384.png 768w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Version-tracking-webhook-1536x768.png 1536w, https:\/\/www.process.st\/help\/wp-content\/uploads\/2025\/03\/Version-tracking-webhook-2048x1024.png 2048w\" sizes=\"(max-width: 2560px) 100vw, 2560px\" \/><\/p>\n<p><strong>Note:<\/strong> You&#8217;ll need to be an Admin to create webhooks.<\/p>\n<p>This enables you to run a training workflow when a policy or procedure has significantly changed, for example.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Version Control and audit history logs allow you to systematically track document changes, maintain comprehensive version history, and ensure compliance with regulatory standards, such as ISO 9001. You can maintain detailed, immutable records of who made changes and when actions occurred. You can then easily export or share those records with external stakeholders or auditors. [&hellip;]<\/p>\n","protected":false},"author":11,"template":"","meta":{"_acf_changed":false,"available_plan":"Add-on","available_product":"Forms, Pages, Settings, Workflows","footnotes":""},"ht_kb_category":[483,218,239,158],"ht_kb_tag":[519,579,470],"class_list":["post-8590","ht_kb","type-ht_kb","status-publish","hentry","ht_kb_category-forms","ht_kb_category-pages","ht_kb_category-security","ht_kb_category-build-edit-workflows","ht_kb_tag-compliance","ht_kb_tag-version","ht_kb_tag-versioning"],"acf":[],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb\/8590","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb"}],"about":[{"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/users\/11"}],"version-history":[{"count":32,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb\/8590\/revisions"}],"predecessor-version":[{"id":10355,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb\/8590\/revisions\/10355"}],"wp:attachment":[{"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/media?parent=8590"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb_category?post=8590"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb_tag?post=8590"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}