In short: if an update breaks your theme, you can revert to a stable version in under a minute.
Discover our best HubSpot Agency tips!
What HubSpot allows you to restore
HubSpot automatically keeps a history of most elements you modify. Concretely, you can restore:
A - Pages and blog posts
All pages (website pages, landing pages, blog posts) have a history accessible from the editor. Each unpublished save creates a restorable version.
B - Themes, modules, and coded files
In the Design Manager, each template, module, HTML/HubL file, CSS, or JS file has its own history. This is where you restore a broken theme or module version.
Limitations to be aware of
-
An email that has already been sent cannot be restored.
-
A deleted page cannot be recovered via history: only HubSpot Support can restore it.
In summary: almost everything is versioned in HubSpot, except content that has already been sent or permanently deleted.
Restore a theme file version (the key method)
To roll back a theme file, module, or any coded file, everything happens in the Design Manager, where HubSpot stores the complete history of each element.
1. Access the Design manager
In your HubSpot account, go to: Content → Design Manager. Then select the relevant file (template, module, CSS, JS…).
2. Open “View revisions”
Click Actions → View revisions. HubSpot displays all previous saves: who modified what and when.
3. Choose a version → Restore → Publish
Select the version that worked, click Restore, then Publish changes.
Without publishing, the restoration will not be applied to the site pages. This is the most reliable method to fix a broken theme or module: three clicks and everything is back in order.
Restore a page version
For a website page, landing page, or blog post, HubSpot automatically saves all unpublished versions. Restoration is done directly from the editor.
1. Open the history from the editor
From the relevant page → View → Version history (You can also access it via the “Saved” status in the top right.)
2. Preview → restore → Re-publish if needed
Click a version to preview it, then click Restore. HubSpot creates a new draft based on this version: you can visually check it, then publish to make the restoration live.
Simple, fast, no technical handling required.
Best practices to avoid errors
Even though HubSpot makes restoration easy, a few simple habits help prevent 90% of issues.
Most important: never modify a theme’s source directly.
1. Use a child theme
This is the cleanest method: changes are isolated, easy to undo, and have no impact on the original theme.
2. Clone before a major change
Before editing a global module, CSS/JS file, or template, create a copy. In case of a bug → instant rollback.
3. Always publish after restoring
Whether it’s a file, module, or template: a restoration only becomes effective after clicking Publish changes.
Common issues & solutions
- The restored version does not appear online
→ You probably forgot to publish. Restoring alone does nothing on the front end.
- A page breaks after restoring the theme
→ Often caused by a missing module in the older version.
Solution: restore only the impacted file, not the entire theme.
- The history is empty
→ The file or page has never been published, so no version exists yet.
FAQ – Restoring a previous version of a HubSpot theme
How do I revert to an older version of my HubSpot theme?
Theme file restoration is done in the Design Manager. Path: Content → Design Manager → relevant file → Actions → View revisions.
Then simply select the desired version, click Restore, and Publish changes to apply the rollback across your HubSpot site.
Why doesn’t the restored version appear on the site?
Because a restoration is only active after publishing. Even if the version is restored in the Design Manager, it remains in “draft” state until you click Publish changes.
Once published, it propagates to all pages using that file.
Can I restore a deleted page?
No, not directly from your account. The history disappears when a page is deleted.
The only solution is to contact HubSpot Support, who can sometimes restore the page from their system backups.
Can I restore a previous version of an email?
Yes, but only for:
-
draft emails,
-
automated emails.
However:
-
an email that has already been sent cannot be restored,
-
its history is no longer accessible.
In case of an error, you can duplicate the email to fix it.
What if restoring the theme breaks some pages?
This often happens when you restore a theme version in which certain modules did not yet exist. As a result, some pages lose blocks or display incorrectly.
Recommended solutions:
-
restore only the impacted file rather than the entire theme;
-
check the module’s history in the Design Manager;
-
use a child theme to isolate changes and avoid incompatibilities.
How can I avoid needing to restore versions in the future?
A few best practices significantly reduce risk:
-
always work in a child theme,
-
clone the theme before major changes,
-
keep a code change log,
-
test changes on a draft page before publishing,
-
use HubSpot CLI + GitHub for proper version control if doing advanced development.
These measures make restorations simpler—and, above all, much less frequent.
Photo by Steve Johnson
.webp)
