Create a version

Last modified on 08/18/2026 4:51 pm EDT

Create versions in articles and in custom content categories to stage new content, get review before those changes go live, or keep a detailed history of changes made to your content.

Authors with the default Editor or Writer role can create both article versions and custom content category versions. If you're using a custom role:

To create article versions, you'll need the Articles custom author role permission to Create new versions of articles.
To create custom content category versions, you'll need the Categories custom author role permission to Edit categories.

The information below varies based on whether you're using our 2026 new editor or old editor.

To figure out which instructions to follow:

Open any article for editing.
If the lefthand navigation is collapsed and there's a link near the top of the page to Switch to old editor, follow the New editor documentation.
If the lefthand navigation is expanded and the top of the editor and the righthand column have a heavier grey background, follow the Old editor documentation.

Here are side-by-side examples of the new editor and the old editor:

Sample New editor

Sample Old editor

Try out the new editor
We'd love your feedback on the new editor. To switch to the new editor, open any article for editing and select the Switch to new editor link at the top of the editor.

To create an article version in the new article editor:

Open the article in the editor.
In the Versions section near the top of the righthand column, select
In the Versions section near the top of the righthand column, select + New version:

Select + New version to begin creating a new version.
The Create new version modal opens.
Select the Version name you'd like to use:
1. Select Major (+1.0) to create an automatically numbered major version (x.0) from the current active version and any other major versions.
  1. If you only have version 1.00, Major creates a new version numbered 2.00.
  2. If you have version 2.00, Major creates a new version numbered 3.00.
2. Select Minor (+0.01) to create an automatically numbered minor version (0.x) from the current active version and any other minor versions.
  1. If you only have version 1.00, Minor creates a new version numbered 1.01.
  2. If you have version 1.02, Minor creates a new version numbered 1.03.
3. Select Custom to manually add your own version name. Enter your version name in the textbox below the Custom field. We like to use dates for ours!
  
  Enter your custom version number and select Create.
Optional: If you already know a little about why you're creating this version, enter some Version notes about why you're creating the new version.
Select Create new once you're finished making your selections.
If you had no unsaved changes in the editor when you began creating your new version, the new version is created from the current active version and the editor will refresh to open to that new version.
If you had any unsaved changes in the editor when you began creating your new version, the Unsaved changes modal opens to ask how you'd like to proceed. Choose from these options:
1. Save and create version: If you select this option, your edits in the current version will be saved before the new version is created. If you were editing the current active version, you'll see those edits reflected in both the current version and the newly-created version.
2. Discard changes: If you select this option, your edits in the current version will be discarded.
3. Cancel: This option will cancel the creation of the new version and return you to your unsaved changes in the editor. This can be a good option if you want to copy the current changes without saving them to the current version.
4. The new version is created from the current active version and the editor will refresh to open to that new version.

You can tell which version you're currently viewing by looking for the white card around the version and the black eyeball next to the version name:

Sample Viewing badgeWith your new version created, you can begin making edits to that version.

Toggle between different versions by selecting other version numbers. the version number. All versions are displayed in reverse chronological order with the most recent at the top. Versions with version notes have a yellow notes icon to the right; versions without notes have a yellow icon with a white plus sign. Select the icon to view the notes.

You can make as many changes to the new version as you'd like. They won't show until you activate this version.

To create a version for a custom content category or for an article in the old article editor:

Open the article or custom content category in the editor.
In the Versions section near the top of the righthand column, select Add version.

Select Add version to begin.
From the Add version dropdown, select the version numbering convention you'd like to use.
1. Minor (+0.01) creates an automatically numbered major version from the current active version and any other minor versions. If you select this option, you'll immediately be taken to the next step.
  1. If you only have version 1.00, Minor creates a new version numbered 1.01.
  2. If you have version 1.02, Minor creates a new version numbered 1.03.
2. Major (+1.0) creates an automatically numbered major version from the current active version and any other major versions. If you select this option, you'll immediately be taken to the next step.
  1. If you only have version 1.00, Major creates a new version numbered 2.00.
  2. If you have version 2.00, Major creates a new version numbered 3.00.
3. Custom allows you to manually add your own version number. We like to use dates for ours! If you select this option, a text box appears. Enter your custom version number in the text box and select Create.
  
  Enter your custom version number and select Create.
If you had no unsaved changes in the editor when you began creating your new version, the new version is created from the current active version and the editor will refresh to open to that new version.
If you had any unsaved changes in the editor when you began creating your new version, a modal opens asking you how you'd like to proceed:
Sample unsaved changes pop-up in article editor version creation flow Choose whether you want to:
1. Save changes to the current version: If you select this option and then Create Version, your edits in the current version will be saved before the new version is created. If you were editing the current active version, you'll see those edits reflected in both the current version and the newly-created version. (This option is selected by default.)
2. Discard changes to the current version: If you select this option and then Create Version, your edits in the current version will be discarded.
3. Cancel: This option will cancel the creation of the new version and return you to your unsaved changes in the editor. This can be a good option if you want to copy the current changes without saving them to the current version.
Once you make your selection and choose Create Version, the new version is created from the current active version and the editor will refresh to open to that new version.

You can tell which version you're currently viewing by looking for the black Viewing badge in the versions list:

The Versions section of the article editor. Five versions are displayed. One is not hyperlinked and has a black Viewing badge next to it. An arrow points to the badge.

Sample Viewing badgeWith your new version created, you can begin making edits to that version.

Toggle between different versions by selecting the version number. All versions are displayed in reverse chronological order with the most recent at the top. Versions with version notes have a yellow notes icon to the right; versions without notes have a yellow icon with a white plus sign. Select the icon to view the notes.

You can make as many changes to the new version as you'd like. They won't show until you activate this version.

Was this article helpful?

Create a version

Related articles