View template versions
Use this page to view and manage the version history for a config template in NGINX One Console. The Versions tab on the Template Detail page lists every version for a template and shows how many submissions reference each version.
A new version is created each time the template content changes. Versions have two states:
draft— editable; content can still be updated in place.final— immutable; any further content changes create a new draft version.
Before you begin, make sure you have:
- NGINX One Console access: You need permission to view config templates.
- An existing template: At least one template must exist in Manage > Config Templates.
- In the NGINX One Console, go to Manage > Config Templates.
- Select a template name from the list.
- Select the Versions tab.
The Versions tab displays the following columns:
| Column | Description |
|---|---|
| Version | The sequential version number. Version 1 is the initial version created at import. Each subsequent content change increments this number. |
| Modified | The date and time the version was last modified. |
| Description | The description associated with the template version, if the author provided one. |
| Submissions | The total number of template submissions that reference this specific version. |
You can sort the list by Version, Modified, or Description. You can also search across all visible columns.
The Submissions count reflects the number of submissions referencing a specific version, not the latest version overall. A version with a non-zero submission count cannot be deleted.
To delete a template version, select Delete on the version row and confirm the pop-up window.
ImportantThe following constraints apply when deleting a template version:
- The latest version cannot be deleted. To remove the entire template including the latest version, use Delete a Template instead.
- A version with associated submissions cannot be deleted. The Submissions column shows the count. Delete the associated submissions before deleting the version.
Select Refresh at the top right of the page to reload the version list from the server.
The Versions tab uses the following API operations:
- List template versions — retrieves all versions for a template.
- Delete a template version — deletes a specific version by its
templateVersionObjectID. Returns409 Conflictif the version has associated submissions.
Symptom: The Delete action is unavailable or returns an error.
Cause: The version has associated submissions, or it’s the latest version.
Fix: Check the Submissions column count. Delete any associated submissions before deleting the version. To remove the entire template including the latest version, use the Delete a Template API operation.
For more information, see: