Versioning on your page
Brienne Wong
As an editor, you can see, restore, and rename previous versions of your styleguide pages with Page versioning. Page versioning shows who edited a page, when, how much the page size changed, and the ability to view, restore, and name a previously saved version. Your viewers cannot restore a previous version.
View version history
1) Click Edited X minutes ago by Name under the page title.
2) Click View next to the version you want to see.
3) You can view the previous version of your styleguide. You can click Restore this version to restore the previous version you’re viewing.
Restore a previous version
1) Click Edited X minutes ago by Name under the page title
2) Click the … menu
3) Click Restore this version
4) Click Confirm restoration
👉 Note: Content blocks (e.g., design uploads or markdown) that are synced from external files will always reflect the state of that source file
5) You’ve now restored the page to the previous version.
Rename a previous version
You can rename a version that has already been created. Unnamed versions will default to “Untitled”.
1) Click Edited X minutes ago by Name under the page title
2) Click the … menu
3) Click Edit version details
4) Enter a Version name and click Save
FAQs
When viewing a previous version, will all content block types reflect that version?
Predominantly yes. Content that’s populated via another source (e.g., Figma, Storybook, and GitHub) will reflect what’s in the source file (tokens, markdown, uploads). This is regardless of the version you’re viewing. We’ll make it clear when viewing an older version which content types are versioned and which aren’t.
When I restore an older version, will every content block type be restored?
Yes, with a few exceptions. This is similar to the question above. If a content type isn’t versioned (but instead pulling through from an external file), then the most recent state of that source file will appear on the page you’ve restored.
What happens if a team member is deleted from the account?
It will say instead Edited X minutes ago by deleted user.
After releasing a styleguide, is that released version fixed, or can it be edited further?
A released version of your styleguide is fixed. It cannot be edited once it’s released.
How is a new version created?
A new version is created:
1) when a different user edits the page
2) when the same user updates the page from a new session (e.g. by revisiting or reloading the page)
3) when 2 minutes have elapsed since the last edit
4) when it has been 10 minutes in total since the version was first created
5) when you reload the current page to force a new version to begin
What versioning feature do I get with my plan?
Based on your plan, you would get:
Free plan
- Version history (who edited a page, when, file size)
- 7 days
- View only
Starter plan
- Version history (who edited a page, when, file size)
- 30 days
- Restore & rename
Pro plan
- Version history (who edited a page, when, file size)
- 90 days of history
- Restore & rename
Enterprise
- Version history (who edited a page, when, file size)
- 1 year of version history
- Restore & rename
Note: Legacy plans do not have access to our versioning features.
What is your content retention policy?
We keep 100 previous versions of the page you’re editing, regardless of age and this is reflected in the version feature tool. For example on the Enterprise plan we keep 1 year of version history (up to 100 versions).