Skip to main content

Version history

Figma allows you to distinguish different stages or Versions of a file, as the file evolves over time. This is all recorded in the Version history, which allows users to view, track and restore previous versions of a file.

warning

IMPORTANT: The order of versions returned by GET file versions has changed. Versions are now ordered explicitly by when they were created. As a part of this change, the URL format for next_page and prev_page has also changed.

For more information, see the changelog.

Types​

Figma will record some basic information about the file, like the who and when, as well as allow the user to determine a title and description for the version. These form the basis of the properties associated with version history.

TypeProperties

Version​

A version of a file.

idString
Unique identifier for version.
created_atString
The UTC ISO 8601 time at which the version was created.
labelString
The label given to the version in the editor.
descriptionString
The description of the version as entered in the editor.
userUser
The user that created the version.