# Migrate from Mosaic for Confluence ✅ You can migrate from the **Mosaic for Confluence** app (by Kolekti / Adaptavist) to Capable. There are several macros included in this app that can be migrated. ## [#](#background)Background The Mosaic Background macro (`cfm-background`) is migrated to **Capable Background**. ### [#](#what-the-migrator-does)What the migrator does * When an image is present, the macro is converted to a Capable Background macro with the image, position, and opacity settings preserved * When no image is present, the macro is converted to a native Confluence panel * Height options (wrap text, medium, large, custom) are mapped to equivalent Capable settings ### [#](#support-level)Support level **Partial** — Image backgrounds are migrated. Some Mosaic-specific options (repeat, size, border radius) are not carried over. Follow the instructions on **Using the migration assistant** to run the migrator. ### [#](#example)Example ![](https://images.unsplash.com/photo-1618005182384-a83a8bd57fbe?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3w2MDM1MTR8MHwxfHNlYXJjaHwxfHxhYnN0cmFjdHxlbnwwfHx8fDE3NTU1OTI4OTF8MA&ixlib=rb-4.1.0&q=80&w=1080) **Make content stand out** Use a background image or color to highlight important information and create visual separation. --- ## [#](#interactive-banner)Interactive Banner The Mosaic Interactive Banner macro (`cfm-interactive-banner`) is migrated to **Capable Banner**. ### [#](#what-the-migrator-does-1)What the migrator does * Converts the Mosaic interactive banner to a Capable Banner macro * Banner content and layout are preserved ### [#](#support-level-1)Support level **Partial** — Core banner functionality is migrated. Theme and opacity options are not carried over. Follow the instructions on **Using the migration assistant** to run the migrator. ‹› ![Koala](https://images.unsplash.com/photo-1622547748225-3fc4abd2cca0?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3w2MDM1MTR8MHwxfHNlYXJjaHwxNnx8YWJzdHJhY3R8ZW58MHx8fHwxNzYwMjg3MzAzfDA&ixlib=rb-4.1.0&q=80&w=1080) ### Confluence is better with Capable Capable makes Confluence do more. [Learn more](https://www.gocapable.com) ![Mountain](https://images.unsplash.com/photo-1618005182384-a83a8bd57fbe?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3w2MDM1MTR8MHwxfHNlYXJjaHwxfHxhYnN0cmFjdHxlbnwwfHx8fDE3NjAyODczMDN8MA&ixlib=rb-4.1.0&q=80&w=1080) ### Empower your team This is where the content of your slide goes. [Explore](https://www.gocapable.com) ![Notepad](https://images.unsplash.com/photo-1533158326339-7f3cf2404354?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3w2MDM1MTR8MHwxfHNlYXJjaHwyOHx8YWJzdHJhY3R8ZW58MHx8fHwxNzYwMjg3NTczfDA&ixlib=rb-4.1.0&q=80&w=1080) ### Make your content shine Add images, videos, and more to your content. [Get started](https://www.gocapable.com) --- ## [#](#cards)Cards The Mosaic Cards macro (`cfm-cards`) is migrated to **Capable Cards**. ### [#](#what-the-migrator-does-2)What the migrator does * Maps Mosaic card configuration to the Capable Cards format * Card content and layout are preserved ### [#](#support-level-2)Support level **Partial** — Core card functionality is migrated. Some Mosaic-specific options (palettes, alignment) are not carried over. Follow the instructions on **Using the migration assistant** to run the migrator. ### [#](#example-1)Example [![Banana](https://images.unsplash.com/photo-1528825871115-3581a5387919?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3w2MDM1MTR8MHwxfHNlYXJjaHwxfHxiYW5hbmF8ZW58MHx8fHwxNzU0MTY2OTY1fDA&ixlib=rb-4.1.0&q=80&w=1080)BananaBananas are soft, yellow and sweet - great with porridge oats.](https://www.gocapable.com) [![Mango](https://images.unsplash.com/photo-1551649001-9c071b61f26c?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3w2MDM1MTR8MHwxfHNlYXJjaHwxOHx8bWFuZ298ZW58MHx8fHwxNzU0MTcwNDI1fDA&ixlib=rb-4.1.0&q=80&w=1080)MangoMangoes are a tropical fruit which are very sweet. Try it with pineapple.](https://www.gocapable.com) [![Orange](https://images.unsplash.com/photo-1592187270271-9a4b84faa228?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3w2MDM1MTR8MHwxfHNlYXJjaHw3fHxvcmFuZ2V8ZW58MHx8fHwxNzU0MTY3NTMyfDA&ixlib=rb-4.1.0&q=80&w=1080)OrangeOranges are a round citrus fruit - great for breakfast, ideally juiced!](https://www.gocapable.com) --- ## [#](#button)Button The Mosaic Button macros (`auibutton`, `auibuttongroup`) are migrated to **Capable Button**. ### [#](#what-the-migrator-does-3)What the migrator does * Maps button type (filled, bordered, text) to Capable variant (default, secondary, ghost) * Handles both Confluence page links and external URLs * Button groups are preserved ### [#](#support-level-3)Support level **Partial** — Button types and links are migrated. Some style options are not carried over. Follow the instructions on **Using the migration assistant** to run the migrator. ### [#](#example-2)Example [Open website](https://www.gocapable.com)[Open website](https://www.gocapable.com)[Open website](https://www.gocapable.com)[Open website](https://www.gocapable.com)[Open website](https://www.gocapable.com)[Open website](https://www.gocapable.com)[Open website](https://www.gocapable.com)[Open website](https://www.gocapable.com) --- ## [#](#footnote)Footnote The Mosaic Footnote macro (`cfm-footnote`, `footnote`) is migrated to **Capable Footnote**. ### [#](#what-the-migrator-does-4)What the migrator does * Converts both `cfm-footnote` (inline extension) and legacy `footnote` (bodied extension) macros to Capable Footnote * Footnote content and references are preserved ### [#](#support-level-4)Support level **Full** — All footnote macros are fully migrated. Follow the instructions on **Using the migration assistant** to run the migrator. ### [#](#example-3)Example This is some text[\[1\]](#fn-1) This is some text[\[2\]](#fn-2) --- ## [#](#footnote-summary)Footnote Summary The Mosaic Footnotes Display macro (`cfm-footnotes-display`, `display-footnotes`) is migrated to **Capable Footnotes Summary**. ### [#](#what-the-migrator-does-5)What the migrator does * Converts both `cfm-footnotes-display` and legacy `display-footnotes` macros to Capable Footnotes Summary * The summary block that renders all footnotes on a page is preserved ### [#](#support-level-5)Support level **Full** — Footnotes display macros are fully migrated. Follow the instructions on **Using the migration assistant** to run the migrator. ### [#](#example-4)Example 1. This is footnote 1 [↩](#fn-ref-1) 2. This is footnote 2 [↩](#fn-ref-2) --- ## [#](#progress-tracker)Progress Tracker The Mosaic Progress Tracker macros (`cfm-progress-bar-hyperlink-step`, `auiprogress`, `auiprogressstepstatic`) are migrated to **Capable Progress Tracker**. ### [#](#what-the-migrator-does-6)What the migrator does * Collapses consecutive Mosaic hyperlink step macros into a single Capable Progress Tracker * Supports legacy progress container macros (`auiprogress`, `auiprogressstepstatic`) * Step labels, links, and ordering are preserved ### [#](#support-level-6)Support level **Full** — All progress tracker macros are fully migrated. Follow the instructions on **Using the migration assistant** to run the migrator. ### [#](#example-5)Example ![Capable progress tracker](https://help.gocapable.com/images/c9c14dd3-ccb9-4a98-9323-0d37603546b7.webp) --- ## [#](#tabs)Tabs The Mosaic Tabs macro (`cfm-tabs-page`) is migrated to **native Confluence expand blocks**. ### [#](#what-the-migrator-does-7)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-7)Support level **Full** — All tab content is preserved as expand blocks. Follow the instructions on **Using the migration assistant** to run the migrator. ### [#](#example-6)Example Expander 1 This is some content Expander 2 This is some content Expander 3 This is some content --- ## [#](#expand)Expand The Mosaic Expand macro (`cfm-expand`) is migrated to **native Confluence expand blocks**. ### [#](#what-the-migrator-does-8)What the migrator does * Converts the Mosaic expand to a native Confluence expand block * Title and content are preserved ### [#](#support-level-8)Support level **Full** — All expand content is fully migrated. Follow the instructions on **Using the migration assistant** to run the migrator. ### [#](#example-7)Example Expander 1 This is some content Expander 2 This is some content Expander 3 This is some content --- ## [#](#alerts)Alerts The Mosaic Alert macros (`cfm-alert`, `mosaic-alert`, `alert`) are migrated to **native Confluence panels**. ### [#](#what-the-migrator-does-9)What the migrator does * Maps alert types to Confluence panel types: * Success alerts become success panels * Error alerts become error panels * Warning alerts become warning panels * Info alerts become info panels * Note alerts become note panels * Alert content is preserved inside the panel ### [#](#support-level-9)Support level **Full** — All alert types and content are fully migrated to native panels. Follow the instructions on **Using the migration assistant** to run the migrator. ### [#](#example-8)Example 📝 **Alert** This is an alert in native Confluence. --- ## [#](#tooltip)Tooltip The Mosaic Tooltip macro (`cfm-tooltip`) is migrated to **Capable Tooltip**. ### [#](#what-the-migrator-does-10)What the migrator does * Converts the Mosaic tooltip to a Capable Tooltip macro * Tooltip text and trigger content are preserved ### [#](#support-level-10)Support level **Full** — Tooltips are fully migrated. Follow the instructions on **Using the migration assistant** to run the migrator. ### [#](#example-9)Example This is a tooltip ℹ --- ## [#](#latex)LaTeX The Mosaic LaTeX macro (`latex-formatting`) is migrated to **Capable LaTeX**. ### [#](#what-the-migrator-does-11)What the migrator does * Maps LaTeX expressions to the Capable LaTeX format * Preserves alignment settings (block-align) * Normalizes LaTeX expressions ### [#](#support-level-11)Support level **Full** — LaTeX content is fully migrated. Follow the instructions on **Using the migration assistant** to run the migrator. ### [#](#example-10)Example x2+y2=1y=1−x2\\begin{align\*} x^2 + y^2 &= 1 \\\\ y &= \\sqrt{1 - x^2} \\end{align\*}x2+y2y​\=1\=1−x2​​ --- ## [#](#unsupported-macros)Unsupported macros The following Mosaic macros are detected but **cannot be migrated** at this time. They will appear in the migration assistant with page counts for visibility: | Macro | Notes | | ----------------- | ------------------------ | | Smart Page Editor | Not available in Capable | | BibTeX Reference | Not available in Capable | | BibTeX Display | Not available in Capable |