View a file's version history

Before you start

Who can use this feature

Available on any team or plan. Members of Starter teams can only view 30 days of a file's version history. Members of Professional and Education teams or organizations can access a file's entire version history.

Anyone with Can view access to the file can view and browse the file's version history.

Only people with Can edit access to the file can create, name, remove, or restore a file's version history.

Looking for version control? Learn how to create branches and merge conflicts and changes →

Keep track of changes you've made to your files with version history. Explore a timeline of events dating back to the file's creation.

• View a version to pan around and see a snapshot in time.
• Restore previous versions to edit layers and export assets.
• Duplicate versions to create development-ready files for handoff.
• Share a link to a specific version with other people.
• Create versions to make it easier to view and access a set of changes.
• Add names and descriptions to autosaved versions.

Figma saves your work by adding checkpoints to the file’s version history. Figma records a new checkpoint every 30 minutes and keeps the current version up to date with your file changes.

Access version history

To access a file's version history, you will need to have at least can view access to the file. However, it's not possible for Viewers to make changes to a file's version history. This including creating or naming versions, as well as restoring previous versions of the file.

Access a file's version history from the file name menu.

1. Click on an empty spot in the canvas to deselect any layers.
2. In the toolbar, click the next to the file name.
3. Select Show Version History from the options.
4. Figma will show the file's version history in the right sidebar.

View a timeline of versions dating from the current date and time, to the file's creation.

1. Explore versions of the file that you've created. This includes versions you create when you publish changes to a library. Next to each version you'll see:
   • Name of the version
   • Description of the changes made
   • The time and date the version was created
   • The name and avatar of the main contributor.
2. View the date and time for checkpoints that Figma has automatically saved. Figma will group autosave versions, click to expand and view each autosave. You will need to name a version to add a title and description of your changes.
3. Click Show older to explore more of a file's history.

Create and name versions

You can create and name new versions in your file. This is great for capturing a snapshot of the file at a specific time, or record a specific set of changes.

You can add details to describe the changes you’ve made in this design iteration, or any other details that may be relevant, like a milestone name or related task.

Create a new version

1. Open the menu and select Save to Version History. Or use the keyboard shortcuts:
   • Mac: ⌘ Command ⌥ Option S
   • Windows: Ctrl Alt S
2. Add a Title and Description to summarize your changes and why you made them. You can use this space to add references to milestones or tasks.
   • Figma clips titles longer than 25 characters.
   • To see the full descriptions at a glance make sure your descriptions are less than 140 characters.
   • You can add URLs here, but Figma doesn't turn these into clickable links.
3. Click Save to create a new version.

Name an existing version

You can also name an existing version, to make a version easier to identify in the version history.

1. Open version history in the right sidebar.
2. Click on the version to browse the version in the viewport.
3. In the right sidebar, click next to the version and select Name This Version
   
   

View a version

View another version to see a snapshot of the file at that date and time. When viewing a version of a file, you can:

• Use the page list to view other pages in the file
• Use the Move tool to select and copy assets
• Use the Hand tool to drag to pan around the canvas
• Press ⌘ Command Shift E (Mac) or ⌃ Control Shift E (Windows) to and export assets with export settings applied

Copy assets

Right-click any object and select Copy to copy the layer, or hover over Copy/Paste as for more options:

• Copy as code (CSS, iOS, or Android)
• Copy link for a URL to the layer
• Copy properties of the layer
• Copy text for the text string (text layers only)

Learn more about copying and pasting →

Duplicate a version

Duplicate a version of a file to create a new file from that version. Duplicate to share a specific version or point in time with a developer, or use as a starting point for further iteration.

Collaborators will be able to select, edit, copy, or export assets from the duplicate. They won't be able to access any comments or version history from the original file.

To duplicate a version:

1. Open version history in the right sidebar.
2. Click on the version to browse the version in the viewport.
3. In the right sidebar, click next to the version and select Duplicate
4. Figma will show a notification that the version has been duplicated. Click Open to open the file in a new tab.

Share public and private files → 
Share files in an Organization → 
Share designs with developer handoff →

Restore a previous version

When you are browsing previous versions of a file you have the option of reverting to that file. This will allow you to view, copy, edit, or export anything in the canvas.

You can use this process to:

• View earlier iterations of a design.
• Find and copy accidentally deleted assets.
• Access files that have reached the memory limit.

This is a non-destructive action, so you can still access the current version in the file's version history.

Figma will keep comments from all versions in the file, so restoring a version won't remove any comments from later versions. This includes comments you've already resolved.

Restoring a previous version doesn't restore any deleted comments. Deleting a comment is a permanent action.

To view and restore a previous version:

1. Open version history in the right sidebar.
2. Select the version to preview it in the viewport.
3. In the right sidebar, click next to the version and select Restore This Version.
4. Figma will add two autosave checkpoints to the file's version history.
   • A checkpoint that saves the current version up until you clicked Restore This Version. This as an autosaved version with a timestamp that matches the current time.
   • A checkpoint at the same timestamp for the version you just restored.
5. Click the Edit current version to exit version history.

Restore from version

You can also restore a previous version of a file from the file browser. This is useful if you're no longer able to access a file's version history due to memory or performance issues.

1. Hold down the modifier keys and click on the file in the file browser
   • Mac: ⇧ Shift ⌃ Control ⌥ Option
   • Windows: Alt Shift
2. Select Restore from version.
3. Click Restore next to the appropriate version

Share a version

File links are live by default. When you share a link to a file, anyone viewing the file will see the latest version of the file.

If there's a particular iteration you'd like a collaborator to see, you can also share a previous version of the file. This is handy if you'd like to continue iterating on a design, without that person seeing your changes.

Collaborators will need to have can edit access to view a previous version of a file.

1. Open version history in the right sidebar.
2. In the right sidebar, click next to the version and select Copy link.
3. Share the link with any collaborator that has can edit access to the file.

Delete a version

It's not possible to remove checkpoints from the file's history. It is possible to delete the information related to some versions, including:

• New versions you have created
• Versions you have named
• Versions Figma created any time you published changes to a library

If you delete the version information, Figma will treat this like an autosave version and show only a date and time. This won't remove any contents from your file, or prevent you from viewing that version of the file.

You can't undo the action of deleting version information. You can name the autosaved version again to create a new checkpoint in the file's version history.

1. Open version history in the right sidebar.
2. Find the version you want to delete.
3. In the right sidebar, click next to the version and select Delete Version Info.
4. Figma will remove that version from the file's history.

Version history in Dev Mode

Before you Start

Who can use this feature

Available on the Organization and Enterprise plans.

Users with full or dev seats can access the focus view in Dev Mode.

Similar to the version history for a file, Dev Mode provides a version history with descriptions for individual designs in a file. While in Dev Mode, you can focus on designs that are marked Ready for dev to see the version history. Learn more about the version history available in focus view →