Need help migrating with Mosaic?
Whatever stage you're at, we're here to support your migration. Our team is happy to answer any burning questions or help you move confidently with Mosaic.
Fancy Bullets Macro Migration Guide
Learn how to seamlessly migrate the Mosaic Fancy Bullets macro from Confluence Data Center to Cloud with our step-by-step guide. Ensure a smooth transition with clear instructions and best practices.
This step-by-step guide will walk you through the process of migrating the Mosaic Fancy Bullets macro from Confluence Data Center (DC) to Confluence Cloud.
Pre-Migration - Prepare for Migration
1. Audit of Macro Usage
As with all migrations, it is best to identify all pages that use Mosaic macros, particularly those that use nested macros. Our Mosaic Usage Report tool can help you do this by listing all pages containing Mosaic macros and showing their migration readiness status.
To use the Mosaic macro reporting tool:
- Click the Cog>General Configuration in the top-right corner to open Confluence Administration.
- Navigate to Mosaic Macros.
- Click Mosaic Usage Report.
- Click Start scan. The scan will begin.
- Once the scan is complete, click to Download Report.
2. Review Nesting
Confluence Cloud imposes stricter nesting (where one macro inside another) limits than Confluence DC. Make a note of any pages that contain nested Mosaic macros, as these may need adjustments after migration.
Pages with extensive nesting, especially when combining third-party and Mosaic macros, may not migrate correctly. Contact us for tailored support if this applies to your content.
3. Assess CSS Style Sheets
If your Fancy Bullets macros rely on the CSS Stylesheet Macro, be aware that this styling may not fully transfer to the cloud Editor.
- Review pages for any custom CSS.
- Document where these are used, as manual changes may be required.
Migration - Migrating pages with Fancy Bullets Macros
1. Run the Atlassian Confluence Cloud Migration Tool
Refer to Atlassian’s documentation for guidance on using the migration tool.
Pages are imported into the new Cloud site using the Cloud Editor.
2. Review Migrated Pages
Once the migration is complete, open the migrated pages that contain Mosaic Fancy Bullets macros.
Fancy Bullets appear in the Cloud Editor inside a Legacy macro; depending on the bullet type selected, the output may not be as expected. If you have Fancy Bullets using the Image option, it is likely these will not render correctly in the Cloud Editor.
Although several of the other bullet options in Fancy Bullets appear as expected after migration, formatting is reset to standard Confluence bullets when they are edited.
Post-Migration - Replace with Built-in Formatting
After migration, we suggest you remove all Fancy Bullet lists from your Cloud pages and replace them with either the built-in Confluence bullet lists or use Mosaic Advanced Cards to create a visually appealing alternative to lists.
