---
title: "What changes: Toolkit versions"
canonical: "https://help.refined.com/space/MIGRATETOOLKITCLOUD/7058882632/What%20changes%3A%20Toolkit%20versions"
format: markdown
---
## Paths covered

- **DC → Forge Native** (Macro Toolkit and/or UI Toolkit)
- **Refined Toolkit (old Cloud app) → Forge Native**
- **Macro Toolkit Connect-on-Forge → Forge Native**
- **UI Toolkit Connect-on-Forge → Forge Native**

## What changes

| What changes | DC → Forge Native | Refined Toolkit (old Cloud app)  → Forge Native | Macro Toolkit CoF → Forge Native  
  
*(same changes apply if you’re moving from the old Toolkit Cloud app)* | UI Toolkit CoF → Forge Native  
  
*(same changes apply if you’re moving from the old Toolkit Cloud app)* |
| --- | --- | --- | --- | --- |
| **Themes & visual customization** |
| Space themes (background colours and images on pages) | — | Not supported. Use Page Builder modules or the Navigation menu for branding instead. | — | — |
| **Macro nesting** |
| Native Atlassian macros nested inside Refined macros  
*e.g. Table of Contents inside a Tab or Panel* | Not supported. Content is not lost but will not be visible on published pages until moved outside the macro. | Not supported. Content is not lost but will not be visible on published pages until moved outside the macro. | Not supported. Content is not lost but will not be visible on published pages until moved outside the macro. | — |
| Third-party or Connect-on-Forge macros nested inside Refined macros | Not supported. Content is not lost but will not be visible on published pages until moved outside the macro. | Not supported. Content is not lost but will not be visible on published pages until moved outside the macro. | Not supported. Content is not lost but will not be visible on published pages until moved outside the macro. | — |
| Refined macros nested inside Refined macros  
*e.g. Tab inside a Panel* | Existing nesting is preserved via the [Legacy Content Macro](https://support.atlassian.com/confluence-cloud/docs/the-legacy-content-macro/) — content remains visible and readable. Re-editing or restructuring the nesting is not possible in the new editor. | Existing nesting is preserved via the [Legacy Content Macro](https://support.atlassian.com/confluence-cloud/docs/the-legacy-content-macro/) — content remains visible and readable. Re-editing or restructuring the nesting is not possible in the new editor. | Existing nesting is preserved via the [Legacy Content Macro](https://support.atlassian.com/confluence-cloud/docs/the-legacy-content-macro/) — content remains visible and readable. Re-editing or restructuring the nesting is not possible in the new editor. | — |
| Editing existing bodied macro content  
*Known Atlassian platform bug* | Not currently supported by Atlassian. However we have introduced a workaround that will enable the editing/saving of the macro. | Not currently supported by Atlassian. However we have introduced a workaround that will enable the editing/saving of the macro. | Not currently supported by Atlassian. However we have introduced a workaround that will enable the editing/saving of the macro. | — |
| **Images** |
| External image URLs in macros and Page Builder  
*Previously: paste a URL to use a web-hosted image* | Not supported. Previously added images can be downloaded from the macro editing interface and re-uploaded locally. | Not supported. Previously added images can be downloaded from the macro editing interface and re-uploaded locally. | Not supported. Previously added images can be downloaded from the macro editing interface and re-uploaded locally. | Not supported. Local image upload remains available. |
| **Macros not available on Cloud (DC migrations only)** |
| DC-only macros with no Cloud equivalent  
*e.g. Image macro, Profile macro, Divider macro, and others* | Not available on Cloud. See [full list of differences between DC and Cloud](https://help.refined.com/space/MIGRATETOOLKITCLOUD/5333844090/Differences+between+Server%2FData+Center+and+Cloud+in+Macro+Toolkit). | — | — | — |
| **Page Builder (UI Toolkit)** |
| Page Builder data retained after uninstall  
*Only relevant during the transition window between uninstalling old app and installing new one* | — | Page Builder data is retained for 1 month after the old app is uninstalled. Install the new app within this window to avoid data loss. | — | — |
| Historical layout versions in Page Builder  
*Previously: browse and restore prior layout versions within the app* | Not supported. Use [Confluence page versioning](https://support.atlassian.com/confluence-cloud/docs/view-page-history-and-manage-page-versions/) to access previous versions instead. | Not supported. Use [Confluence page versioning](https://support.atlassian.com/confluence-cloud/docs/view-page-history-and-manage-page-versions/) to access previous versions instead. | — | Not supported. Use [Confluence page versioning](https://support.atlassian.com/confluence-cloud/docs/view-page-history-and-manage-page-versions/) to access previous versions instead. |
| **App upgrades** |
| Automatic app updates  
*Forge Native is a major release (8.x) requiring manual action* | A Confluence admin must manually upgrade the app. It will not be applied automatically. | A Confluence admin must manually upgrade the app. It will not be applied automatically. | A Confluence admin must manually upgrade the app. It will not be applied automatically. | A Confluence admin must manually upgrade the app. It will not be applied automatically. |

> 📝 **Macro content is never permanently lost.** Nested content is preserved via the Legacy Content Macro and remains visible in read mode. Limitations apply to editing and restructuring only.

> ⚠️ **Refined Toolkit (old Cloud app) ****will be deprecated** January 31st, 2027. Basic maintenance only - no new features will be released for it.

## Related documentation

- [Migration guide — Toolkit DC to Cloud](https://help.refined.com/space/MIGRATETOOLKITCLOUD/5333811395/Migration+guide)
- [Differences between DC and Cloud — Macro Toolkit](https://help.refined.com/space/MIGRATETOOLKITCLOUD/5333844090/Differences+between+Server%2FData+Center+and+Cloud+in+Macro+Toolkit)
- [Legacy Editor and nested bodied macros](https://help.refined.com/space/MIGRATETOOLKITCLOUD/6359089167/Legacy+Editor+%26+Nested+bodied+macros)
- [Macro Toolkit — going Forge Native](https://help.refined.com/space/MACROTOOLKIT/6828064785/Macro+Toolkit+is+going+Forge+Native%2FRuns+on+Atlassian)
- [UI Toolkit — going Forge Native](https://help.refined.com/space/UITOOLKIT/6826360860/UI+Toolkit+is+going+Forge+Native%2FRuns+on+Atlassian)
- [Moving from Refined Toolkit (old app) to the new Toolkit apps](https://help.refined.com/space/TOOLKITCLOUD/6438846488/Moving+to+the+new+Toolkit+apps)