Managing Template Versions
Published template versions never change. To change a template you save a draft and publish it as the next version. This page also covers viewing versions, promoting a workspace template to the organization, and deleting a template.
Before you begin
- Open Settings > Workspace > Templates. Each row is one template, not one version.
- Read the Version column: it shows the latest published version, such as v2, or Not published. A Draft v3 tag means an unpublished draft exists.
Edit a template
- In the row, select the edit icon. It opens the existing draft if there is one, otherwise the latest published version.
- Change the fields or text.
- Select Save draft, or select Publish as v followed by the next number.
The drawer tells you what happens. On a published version it reads: "Version n stays as it is. Your changes are saved as a draft and published as version next." When a draft already exists it warns: "Saving replaces the current draft (vn)."
The next number is always one more than the highest existing version. Editing v1 when v3 exists produces v4.
View or edit an earlier version
- In the row, select the versions icon, labeled Versions of followed by the template name.
- Select a version number such as v2 to view it, or select the edit icon to continue from that version's text.
Each version shows a Draft or Published status. Saving from an earlier version creates a draft with its text, and publishing makes it the newest version.
Discard a draft
- Open the versions dialog.
- Select Discard draft.
- In Discard draft?, select Discard.
The draft is deleted. Published versions are not affected. A Draft discarded message confirms it.
Promote a template to the organization
Promote a workspace template when other workspaces need it.
- In the row, select the promote icon, labeled Promote followed by the template name to organization. Only Workspace level rows have this icon.
- In Promote to organization, select Promote.
All versions become available to every workspace in the organization. Workflows that already use the template keep working. You cannot undo a promotion.
If the organization already has a template with the same name, the promotion fails and nothing changes. Rename the workspace template and publish it so the new name applies to every version, then promote it.
Delete a template
Deleting removes every version and cannot be undone.
- In the row, select the delete icon.
- Wait for the dialog to finish checking where the template is used. The check runs when the dialog opens. After you update or undeploy workflows, close the dialog and open it again.
- Select Delete.
The dialog tells you what it found:
| Message | Meaning | What to do |
|---|---|---|
| No workflows use this template. | Nothing refers to it. | Select Delete. |
| Cannot delete: N deployments use this template | A deployed workflow, or one waiting for deployment, uses a version. Each item reads workspace / application / workflow (environment, vN), where vN is the workflow version. | Update those workflows to another version, or undeploy them. Delete stays disabled until then. |
| Used by N workflows being authored | Workflows that are not deployed yet use it. | Delete is enabled. Deleting removes the template those workflows point to. Update them first if they still need it. |
| Could not check where this template is used. | The lookup failed. Workflows in any workspace may still use the template. | Close the dialog and open it again before you delete. Delete stays enabled, but the service still refuses if a deployed workflow uses the template. |
How you know it worked
A message confirms the action: name published, name saved as draft, Draft discarded, name is now an organization template, or name deleted. The list updates, and a promoted template shows Organization in the Level column.