Version control

Keep track of changes, roll back to a previous version and more

You can easily monitor all the changes people have made to your content using to the Version history side panel.

Version history

In the Version history of a space, you can see a list of all the actions that changed the content within it. These include:

• When someone made live edits to the space.
• When someone merged a change request.
• When someone performed a Git Sync operation.

View historical versions of content

To view past versions of your content and see the changes that were made, click the Version history button in the space header, or open the Actions menu next to the space or change request title and choose Version history.

Click on any item in the list to see how your content looked at the point this change was made. This is very similar to how you view change requests.

Show changes

When you are viewing an old version of your content, the GitBook interface will automatically show you a comparison view of what has changed in this version — similar to diff view in a change request.

If a page contains diffs, GitBook also shows a floating centered indicator. Click it to scroll to the first changed block or element.

By default, changes will be shown with the 'before' version on the left and the 'after' column on the right, also known as "split-view". You can also view changes inline and within a single column by clicking the Split/Stacked button at the top-right of the Table of content panel.

Viewing historical published versions

If you're investigating the version history of a published space, you can also view previews of what the previous versions looked like in the published context (i.e. what the end user would see).

You can do this by:

1

From the version history side panel, select the revision

2

Copy the ID at the end of the URL

3

Add it at the end of your published docs URL as /~/revisions/<id>

Roll back to a previous version

Rolling back allows you to revert a space’s content to the way it was at a previous point in time. This is helpful if you’ve accidentally made a breaking change or deleted content and need to quickly get back to a previous version of the space.

To roll back to a previous version of your space, hover over the version in the side panel, click the Actions button and select Rollback.