Aura Apps Migration Hub

This page helps you understand how your existing Aura Apps macros and content can be migrated to Mosaic.

The following page provides details on each features migration support status, available workarounds, and useful tips to help you prepare for a smooth migration.

Supported Categories


Category	Definition	Used When
Supported	Content is not lost during migration, including text and icons, even if styling, spacing, colours, or other minor presentation details change.	All text is preserved. Only minor styling differences exist, such as padding, font size, colour shade, border style, or alignment.
Partially Supported	Content is only partly migrated, some content is lost, or there is a feature gap between the original macro and the migrated result.	Content, such as text or icons, is missing after migration. A functional capability or behaviour, such as link actions, is missing. The macro becomes static where the original had meaningful dynamic behaviour.
Unsupported	The macro cannot be migrated.	The functionality of the original macro is completely lost during migration.

Macro Support Status


Macro/Feature Name	Support Status	Notes
Tabs	Supported	Tab structure will migrate correctly, however some features are not available in Mosaic. See the Tabs section below for more information.
Expand	Supported	Structure and content migrates well, however some styling features are not available in Mosaic. See the Expand section below for more information.
HTML	Supported	Supported in line with our sanitisation rules outlined here. Note that Mosaic Advanced edition is required for JavaScript.
Cards	Partially Supported	Aura provides multiple card types and customisation options. Not all of these card types are available in Mosaic. See the Cards section below for more information.
Buttons	Partially Supported	Button structure and content will migrate correctly, however some features are not available in Mosaic. See the Buttons section below for more information.
Numbered Headings	Partially Supported	There are small feature gaps between Aura Numbered Headings and Mosaic Numbered Headings. See the Numbered Headings section below.
LaTeX Math	Partially Supported	There are small feature gaps between Aura LaTeX Math and Mosaic LaTeX macros. See the LaTeX Math section below.
Background	Partially Supported	There are small feature gaps between Aura Background and Mosaic Background macros. See the Background section below.
Divider	Unsupported	Unsupported for migration, however simple line dividers can be replicated by HTML, see the Divider section below.
Panel	Unsupported	Unsupported for migration, however the body can be replicated using Mosaic Background macro. See the Panel section below.
Embed	Unsupported
Progress Bar	Unsupported
Title	Unsupported	Unsupported for migration, however there are several workarounds available using Mosaic macros. See the Title section below.
Child Tabs	Unsupported
Dynamic Content	Unsupported
User Profiles	Unsupported
Status Drop down	Unsupported
Countdown	Unsupported
Announcements	Unsupported
Custom Fonts	Unsupported
Templated Macros Library	Unsupported
Color Palettes	Unsupported	No direct migration available however Aura Color Palettes can be replicated with Mosaic Brand Kits and custom Color Palettes. See the Color Management section below.
Custom Icons	Unsupported

Additional Migration Information and Workarounds

Tabs

Aura Tabs without title icons are considered fully supported for migration.

If your Aura Tab macros contain icons in their titles we consider migration to be partially supported as title icons are not supported in Mosaic Tab macros and will be lost on migration.

Other small losses in functionality include:

Active/inactive/mouse hover styles cannot be configured in Mosaic.
Styling options are more extensive in Aura. Minor styling differences will be present after migration, such as padding, font size, colour shade, border style, or alignment.

Expand

Aura Expand macros without title icons are considered fully supported for migration.

If your Aura Expand macros contain icons in their titles, we consider migration to be partially supported as title icons are not supported in Mosaic Expand macros and will be lost on migration.

Styling options are more extensive in Aura. Minor styling differences will be present after migration, such as button icon and text formatting/alignment.

Cards

Mosaic does not support Flip, Hover, or Dynamic Aura cards.

Classic cards can be well replicated using Mosaic cards with the following caveats:

Mosaic does not support some advanced card functions such as:
- Attachments
- Email
- Actions
Styling options are more extensive in Aura. Minor styling differences will be present after migration, such as icons, hover effects, rounded corners, and card padding.

Buttons

Aura Button macros migrate well to Mosaic with the following caveats:

Mosaic does not support some advanced button functions such as:
- Attachments
- Email
- Actions
Styling options are more extensive in Aura. Minor styling differences will be present after migration, such as shape, icons and hover effects.

Numbered Headings

Numbered Headings migrate well from Aura to Mosaic however Mosaic Numbered Headings does not support:

Starting number
Starting heading
ISO-2145 format

LaTeX Math

The Aura LaTeX Math macro migrates well from Aura to Mosaic however Mosaic does not support anchors. There is also no font size option available in Mosaic.

Background

The Background macro migrates well from Aura to Mosaic however Mosaic does not support dark mode, and vertical padding cannot be configured in Mosaic.

Divider

The Aura Divider macro cannot be migrated to Mosaic, however a similar outcome can be achieved using the Mosaic HTML macro. Using the Mosaic HTML Macro users can create simple line and text dividers using CSS.

Note: Dividers with icons cannot be replicated due to sanitisation rules in the Mosaic HTML macro.

Panel

The Aura Panel macro cannot be migrated to Mosaic, however a similar outcome can be achieved using the Mosaic Background macro with some caveats:

There is no title field in the Mosaic Background macro.
The Mosaic Background macro does not support advanced panel functions available in Aura Panels such as:
- Attachments
- Email
- Actions

Title

The Aura Title macro cannot be migrated to Mosaic, however a similar outcome for some use cases can be achieved Mosaic macros.

Users can create title banners with background images, using the Mosaic Background macro.
Banners including hero and CTAs can be created using the Mosaic Interactive Banner macro.
For other more complex use cases, see our documentation on the Mosaic HTML macro.

Color Management

There is no direct migration between Aura Color Pallets and Mosaic however custom brand kits and color pallets can be easily configured in Mosaic. See our documentation for more details on how to set these up.