When you’re building, you may try a change and realize the previous version worked better for your project. For example, maybe you switched a project’s color scheme and later wanted the old one back. Bolt backs up your projects in multiple ways and gives you different options for how to view version history and restore backups.

Understanding backups, restoring, and version history

Backups, restoring, and version history all work together to keep your projects safe and flexible.
  • Backups are saved copies of your project, created automatically or manually, so you always have something to fall back on.
  • Version history (which you can see using the View history button) is a timeline of changes, letting you see how your project has evolved and pick out the exact point you want to return to.
  • Restoring is the act of bringing back one of those saved states, whether it comes from your history, a dated backup in Project settings, or a manual download.
Having multiple backups and an easy way to switch between them means you can experiment without worrying about losing your progress. You can try out new ideas freely, knowing you can return to an earlier version at any time.

Ways to restore your projects

Bolt gives you flexibility with multiple backup methods. Here are the different ways you can bring a project back to an earlier state:
  • Version history ( ✅Recommended) – Browse, preview, label, and restore older versions of your project automatically saved by Bolt using the View history button.
  • Chat history – Scroll through the chat history and click the version you want to restore.
  • Manual Backups – Download a local copy of your project and restore it through your StackBlitz account.
  • GitHub Integration – Manage versioning through GitHub repositories.

Restore using version history

This is our recommended method of restoring your projects from backup.
You can see a clear visual timeline of your backups and edit their names for clarity. You can also preview a backup before restoring it to make sure it’s the one you want. To restore a backup using version history, follow the steps below:
  1. Open a project that you’ve made changes in.
  2. Click View history
  3. Review the list of versions, or search for one.
  4. Click the version you want, which opens its preview mode.
  5. Click Restore this version in the top-right of your screen.
  6. Click Restore version to confirm.
After following these steps, you should see a success message in the chat history telling you that the version you selected has been restored.

Change a backup name in version history

Version history lets you rename autogenerated backup names so they’re easier to recognize. To do so, follow these steps:
  1. Open a project that you’ve made changes in.
  2. Click View history
  3. Review the list of versions, or search for one.
  4. Hover over the version and click the pencil icon.
  5. Change the name.
  6. Click the blue checkmark to save.

Bookmark a backup in version history

Version history also lets you bookmark backups so you can quickly find important versions later. To do bookmark a backup, follow these steps:
  1. Open a project that you’ve made changes in.
  2. Click View history
  3. Review the list of versions, or search for one.
  4. Hover over the version and click the bookmark icon.
You’ll now see that version show up in the Bookmarked Versions section of Version history.

Restore using your chat history

Version history gives you a quick overview of your backups so you can easily pick the right one without mixing them up. However, if you already know which backup you want and it’s recent, you may find it easier to restore directly from the chat To restore from chat, follow the steps below:
  1. Scroll up in your chat history and find the version you want to restore.
  2. Click Restore next to it.
  3. Click Restore Version to confirm.
You can also click the Preview button to view a copy of that backup before choosing to restore.

Export a local copy of your project

You can download a copy of your site to use locally or to restore it in Bolt later. Follow these steps to export your project:
  1. Log in to your Bolt project.
  2. Click your project title at the top of your screen.
  3. Click Export > Download.
This downloads a zipped folder of your project files. You can later use this file to manually restore your project by following the steps in the next section.

Restore from a downloaded copy

You can create a new project from a downloaded copy of your Bolt project by following the steps below:
  1. Log in to your StackBlitz account.
  2. Create a new empty project:
  3. In your StackBlitz account, go to Projects.
  4. Click + New.
  5. Create a new project. It doesn’t matter what type you choose, as you’ll delete the contents.
  6. Delete all the files in the project.
  7. On your computer, unzip the downloaded copy of your Bolt project.
  8. Drag and drop the files from your download into the StackBlitz IDE.
  9. Click Save.
  10. Click Open in bolt.new | AI to open the new project in Bolt.

Restore from GitHub

If you’re using the GitHub integration, you can follow the steps to Import an existing repository. This creates a new Bolt project using the files from your GitHub repository.