> For the complete documentation index, see [llms.txt](https://help.mimeeq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.mimeeq.com/platform/revisions.md). # Revisions Learn how Revisions work in Mimeeq. View change history, restore previous configurations, and understand exactly what gets rolled back per module — from option sets to price lists. ## Content 1. [What are Revisions?](#what-are-revisions) 2. [Supported modules](#supported-modules) 3. [Viewing revision history](#viewing-revision-history) 4. [Restoring a revision](#restoring-a-revision) 5. [What gets restored — per-module breakdown](#what-gets-restored-per-module-breakdown) 6. [Permissions](#permissions) ## Revisions let you track changes to your content over time and roll back to an earlier state if something goes wrong. Each time a supported item is updated, Mimeeq saves a snapshot — giving you up to 30 points in history to restore from. ## What are Revisions? Every time a supported item is saved, Mimeeq creates a revision — a snapshot of that item's configuration at that moment. You can browse the list of revisions and restore any previous one. A few things to know upfront: * Each module stores a maximum of **30 revisions** per item. Once the limit is reached, the oldest revision is removed as new ones are created. * The **latest revision** cannot be restored — it already represents the current state. * Restoring a revision creates a new revision in the history, so you never lose the record of what you did. {% hint style="info" %} Example: You update a 3D material's editor settings and realise they looked better two weeks ago. Open the revision history, find the snapshot from that date, and restore it in one click. {% endhint %} *** ## Supported modules Mimeeq supports two safety features across its modules — **Revisions** and [Trash](/platform/trash.md). Revisions let you roll back changes to an item's configuration at any time. Trash lets you recover deleted items within the retention window. The table below shows which features are available per module, along with Trash limits where applicable. | Module | Revisions | Trash | Max deleted at once | | --------------- | --------- | ----- | ------------------- | | Products | ✅ | ✅ | 20 | | Option Sets | ✅ | ✅ | 1 | | 3D Materials | ✅ | ✅ | 20 | | 3D Scenes | ✅ | ✅ | 20 | | 3D Templates | ✅ | ✅ | 20 | | Collection Sets | ✅ | ✅ | 20 | | Galleries | ✅ | ✅ | 20 | | Embed Templates | ✅ | ✅ | 1 | | Price Lists | ✅ | ❌ | | *** ## Viewing revision history 1. Open the item you want to review (e.g. a 3D material or option set). 2. Navigate to the **Revisions** tab. 3. Browse the list of snapshots — each entry shows the revision type (e.g. *Editor Updated*, *Options Updated*) and the date it was created. ## ![The Revisions tab shows a full change history with the date, author, and type of each update](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FsIc1gc2J7t1CLjs57Dba%2Frevisions-article-1_1c2e9ij.png?alt=media) ## Restoring a revision 1. Open the revision history for the item (see [Viewing revision history](#viewing-revision-history)). 2. Find the revision you want to restore. 3. Click **Restore** next to that revision. The item is updated to match the saved snapshot. A new **Revision Restored** entry is added to the history. {% hint style="warning" %} ⚠️ Important: You cannot restore the latest revision — it is the current version of the item. Restore from any earlier entry in the list. {% endhint %} ## ![The restored entry appears at the top of the history.](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FNUQ0524IhMuXnopb9MXJ%2Frevisions-article-2_jy4mu4.png?alt=media) ## What gets restored — per-module breakdown Revisions do not restore the entire item. **General Tab fields — such as name, status, and description — are never rolled back.** They always reflect the current state of the item, even after a restoration. Only the content-specific sections (editor settings, options, material sets, etc.) are reverted to the saved snapshot. The table below shows exactly what is and isn't restored for each module. | Module | What gets restored | What's never restored | | --------------- | ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | | Products | Product configuration | General Tab (name, variant code, status, description, visibility settings etc.) | | Option Sets | Options | General Tab (name, status, description, display settings) | | 3D Materials | Editor configuration (including Default Material and Environment Texture) | General Tab (name, status, description, thumbnail) | | 3D Scenes | Editor configuration | General Tab (name, status, default material, environment texture) | | 3D Templates | Blocks settings | Name, Status | | Collection Sets | Material sets | General Tab (name, status) | | Galleries | Images | Gallery Name, Number of Columns, Description | | Embed Templates | Name, Language, Public Price List Group; full Settings payload | Unique Name, Customer ID, Translation Set Identifier | | Price Lists | MCP Market, Valid Date, Promo, Cost, RRP, Sale; Companies | Price List Name, Status, Currency, Linked Price List; Price List Body (not stored in revisions) | *** ## Permissions Permissions for restoring a revision are the same as the permissions required to update that item. If you can edit an item, you can restore its revisions. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.mimeeq.com/platform/revisions.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.