# Migrate from Toolkit for Confluence

✅

Both of the Refined Toolkit apps are fully supported for migration!

* [Refined Macro Toolkit (Content Formatting Macros)](https://marketplace.atlassian.com/apps/1211136/refined-macro-toolkit-content-formatting-macros?hosting=cloud&tab=overview)
* [Refined UI Toolkit for Confluence (Page Builder, Navigation)](https://marketplace.atlassian.com/apps/1236998/refined-ui-toolkit-for-confluence-page-builder-navigation?hosting=cloud&tab=overview)

You can migrate from the **Toolkit for Confluence** app (by Refined) to Capable and native Confluence equivalents. There are several macros included in this app that can be migrated.

---

## [#](#panels)Panels

The Refined Panel macros (`refined-panel`, `rw-ui-textbox-macro`, `refined-textbox`, `ui-textbox`, `ui-text-box`, `divbox`) are migrated to **native Confluence panels**.

### [#](#what-the-migrator-does)What the migrator does

* Converts Refined panel/textbox macros to native Confluence panels
* Panel content is preserved

### [#](#support-level)Support level

**Full** — All panel content is fully migrated to native Confluence panels.

Follow the instructions on **Using the migration assistant** to run the migrator.

---

## [#](#steps-stepper)Steps / Stepper

The Refined Steps macros (`rw-ui-steps-macro`, `refined-steps`, `ui-steps`, `refined-stepper`) are migrated to **native Confluence numbered tables**.

### [#](#what-the-migrator-does-1)What the migrator does

* Converts the step-by-step layout into a numbered table format
* Each step's content is preserved in the table

### [#](#support-level-1)Support level

**Full** — All step content is fully migrated.

Follow the instructions on **Using the migration assistant** to run the migrator.

---

## [#](#tabs)Tabs

The Refined Tabs macros (`refined-tabs`, `rw-ui-tabs-macro`, `ui-tabs`) are migrated to **native Confluence expand blocks**.

### [#](#what-the-migrator-does-2)What the migrator does

* Each tab is converted to a Confluence expand block
* The tab title becomes the expand title
* Tab content is placed inside the expand

### [#](#support-level-2)Support level

**Full** — All tab content is preserved as expand blocks.

Follow the instructions on **Using the migration assistant** to run the migrator.

---

## [#](#expand)Expand

The Refined Expand macros (`rw-ui-expand-container`, `refined-expands`, `rw-ui-expands-macro`, `ui-expand`) are migrated to **native Confluence expand blocks**.

### [#](#what-the-migrator-does-3)What the migrator does

* Converts Refined expand containers to native Confluence expands
* Also handles nested tabs within expand containers by converting them to expands
* Title and content are preserved

### [#](#support-level-3)Support level

**Full** — All expand content is fully migrated.

Follow the instructions on **Using the migration assistant** to run the migrator.

---

## [#](#button)Button

The Refined Button macros (`ui-button`, `refined-button`, `rw-ui-button-macro`) are migrated to **Capable Button**.

### [#](#what-the-migrator-does-4)What the migrator does

* Maps button colors to Capable variants:

  * Blue becomes Default
  * Green becomes Success
  * Red becomes Destructive
  * Other colors are mapped to appropriate variants
* Button links and labels are preserved

### [#](#support-level-4)Support level

**Partial** — Button colors and links are migrated. Size and tooltip options are not carried over.

Follow the instructions on **Using the migration assistant** to run the migrator.

---

## [#](#page-tree)Page Tree

The Refined Page Tree macros (`refined-pagetree`, `rw-pagetree-macro`, `rw-pagetree`) are migrated to the **native Confluence pagetree** macro.

### [#](#what-the-migrator-does-5)What the migrator does

* Converts the Refined page tree to a native Confluence pagetree inline extension
* Basic page tree configuration is preserved

### [#](#support-level-5)Support level

**Partial** — Basic page tree functionality is migrated. Specific page references are not supported.

Follow the instructions on **Using the migration assistant** to run the migrator.

---

## [#](#activity-stream)Activity Stream

The Refined Activity Stream macros (`rw-activity-macro`, `refined-activity`, `ui-activity`) are migrated to the **native Confluence recently-updated** macro.

### [#](#what-the-migrator-does-6)What the migrator does

* Converts the Refined activity stream to a native Confluence recently-updated macro
* Activity display settings are preserved where possible

### [#](#support-level-6)Support level

**Full** — Activity stream content is fully migrated to the native equivalent.

Follow the instructions on **Using the migration assistant** to run the migrator.

---

## [#](#unsupported-macros)Unsupported macros

The following Refined macros are detected but **cannot be migrated** at this time. They will appear in the migration assistant with page counts for visibility:

| **Macro**      | **Notes**                                                    |
| -------------- | ------------------------------------------------------------ |
| Countdown      | Countdown timer functionality not available in Capable       |
| Custom Code    | Custom code execution functionality not available in Capable |
| XHTML Text Box | XHTML text box functionality not available in Capable        |