---
title: "Global Data Revisions"
description: "Browse and restore earlier versions of individual classes, components, variables, and other shared Bricks data."
canonical: "https://academy.bricksbuilder.io/builder/interface/global-data-history/"
markdownUrl: "https://academy.bricksbuilder.io/builder/interface/global-data-history.md"
pageType: "article"
section: "builder"
category: "interface"
lastmod: "2026-11-17T10:56:20.000Z"
---
Global data revisions, available since Bricks 2.5, keep earlier versions of shared Builder items. Restore one component or class without replacing newer changes to the rest of your design system. It also lets you recover an item that was deleted.

Revisions are recorded by default. You do not need to enable experimental Drafts to use them.

## Open the revisions

Open **Manage > Global data revisions** in the Builder toolbar. The dialog lists these data types in its sidebar: **Theme styles**, **Classes**, **Variables**, **Colors**, **Components**, **Queries**, and **Query filters**. Type shortcuts 1 to 9 select a type, and Bricks remembers your last type and sort order.

<div className="screenshot screenshot--control-panel">

![The Manage panel with History / Revisions and Global data revisions listed below Theme styles and Page settings.](/assets/builder/global-data-revisions/revisions-settings-panel.webp)

</div>

You can also open the revisions of one data type from where you edit it. Each opens the dialog on that type:

- **Style manager**: the revisions icon on the selected **Theme styles**, **Classes**, **Variables**, or **Colors** item.
- **Class and variable editors**: the **Revisions** button.
- **Browser**: the revisions icon on **Components**, **Query manager**, or **Filter manager**. A component's own **Revisions** icon in the Browser, or on its row in the Components panel, opens that component directly.

![Style manager with the Classes type selected. A revisions icon appears beside Classes and a Revisions button sits under the selected class.](/assets/builder/global-data-revisions/revisions-style-manager-entry.webp)

![The Browser with Components selected. A revisions icon appears beside Components in the sidebar.](/assets/builder/global-data-revisions/revisions-browser-entry.webp)

## Browse an item's revisions

1. Select a data type in the sidebar.
2. Find an item with the search field, which also searches deleted items, or sort the list. Classes, variables, components, queries, and filters also have a categories column, as in their managers.
3. Select an item. Click it again to deselect it.

Theme styles open directly on the active style. Use the style switcher to pick another one. Colors are listed one by one, and each palette appears as a category. A color's revisions come from the revisions of its palette.

An item's revisions form a timeline of cards, newest first. The newest card opens with the item. Select a card to expand or collapse it, or use **Expand all** and **Collapse all** in the item header. The header shows the number of revisions and when the item last changed.

Each card shows the action, such as **Created**, **Changed**, or **Deleted**, along with tags and when and by whom the change was made. A **Current** tag marks the version the site uses now. Source tags such as **AI agent**, **WP-CLI**, **Import**, **Published draft**, or **From a draft** show where a change came from. A change made by hand in the Builder has no source tag. A **Restored** tag marks a revision created by a restore.

An open card lists its changes, one setting per row. Each row shows the setting name with its section underneath, then the old value, an arrow, and the new value. Empty values read **Not set**, colors appear as swatches, and multi-line values such as custom CSS appear as code blocks with the old value dimmed above the new one. The oldest card lists its values under **Oldest recorded version**, because it has no earlier version to compare with. Labels come from the matching Theme styles and settings controls.

![Revisions of the btn-primary class on a timeline. The newest card compares custom CSS as code blocks and the oldest card lists its values under Oldest recorded version.](/assets/builder/global-data-revisions/revisions-class-revisions.webp)

Components also show a rendered preview in each card, and internal component fields are left out of the changes. The preview uses the site's styles. It does not restore the global classes, fonts, or other resources that the component used at that earlier time. Use **Open in new tab** to inspect the preview separately.

![Testimonial card component revisions with a rendered preview and the text change in the newest card.](/assets/builder/global-data-revisions/revisions-component-revisions.webp)

Custom fonts, breakpoints, font favorites, pinned elements, and class locks are not included in global data revisions.

## Restore an item

Each card ends with its own restore button. The current revision has none.

1. Expand the revision you want to recover.
2. Review its values and component preview, if available.
3. Click **Restore this version**. For a color, the button says **Restore this palette version**. For a deleted item, it says **Bring back**.

If you have unsaved changes to that type of global data, the button reads **Save and restore** (or **Save and bring back**) and saves them first.

Restoring saves the selected item's earlier value and updates the Builder. Other items keep their current values. Each restore is recorded as another revision, so you can return to the previous value through the same dialog.

An item's only revision is its recorded starting point and is titled **Current version**.

### Recover deleted items

An item that was deleted or moved to the trash is listed only under **Deleted**, in its own box below the categories, and not in **All** or its category. Select the item and click **Bring back** to return it to use. The item then appears under **All** again. If you open the dialog on a deleted item, it starts in **Deleted**.

![Deleted classes list with old-banner selected. Its Deleted revision shows the removed name and color and a Bring back button.](/assets/builder/global-data-revisions/revisions-deleted-item.webp)

### Restore inside drafts and site versions

When you are editing [a draft](/builder/interface/drafts/) or [a site version](/builder/interface/site-versions/), the dialog shows a notice that the revisions are the live site's history. The newest revision is tagged **Live** instead of **Current**, and you can restore it into the draft, because a draft does not record its own saves and may hold something else. Restored changes follow the [shared-data rules](/builder/interface/drafts/#shared-data). Changes affecting live content stay held until publication. Restored items that do not affect live content are shared across the site immediately. A change held in a draft enters global data revisions when it is published.

Your account needs Builder access and the relevant resource permissions. Restoring a component containing executable code also requires code execution permission.

## Retention and storage

By default, each item keeps its latest **20 versions**, plus all versions recorded in the last **90 days**. An item can therefore have more than 20 revisions. These limits are separate from the number of WordPress revisions kept for a page. Developers can adjust them with [`bricks/global_history/keep_latest`](/developer/hooks/filters/bricks-global_history-keep_latest/) and [`bricks/global_history/keep_days`](/developer/hooks/filters/bricks-global_history-keep_days/).

Under **Bricks > Settings > Builder > Global data revisions**, you can:

- Enable **Disable global data revisions** to stop recording new changes.
- View the storage used by recorded revisions.
- Use **Delete revisions** to remove the stored revisions. This leaves your current global data in place, but the deleted revisions can no longer be restored.

Revisions cannot recover versions that were never recorded. Keep site backups for a complete recovery of WordPress content, media, settings, and files.

## Undo history, revisions, and drafts

| Tool | Use it for |
| --- | --- |
| **History** in Manage > History / Revisions | Undo and redo steps from the current editing session. |
| [Revisions](/builder/interface/revisions/) | Recover earlier page or template elements and page settings. |
| **Global data revisions** | Recover one recorded shared item, including a deleted item. |
| [Drafts](/builder/interface/drafts/) and [site versions](/builder/interface/site-versions/) | Hold changes affecting visitors until you choose to publish them. |

For agent workflows, the `bricks/list-global-revisions` and `bricks/restore-global-revision` abilities provide the same per-item recovery. Pass `target: "active"` to `bricks/restore-global-revision` to bring a deleted item back into use. See [Bricks AI abilities and skills](/builder/features/ai-abilities-and-skills/).