Migrating from another vendor's macros

If you are moving to Capable Formatting from another formatting app, you do not have to rebuild your pages. A migration wizard converts the macros in place.

Formatting has more conversions in that wizard than anything else, by a wide margin, because formatting apps ship the most macros.


#What converts

  • Backgrounds, banners, buttons, cards, LaTeX, tooltips, progress bars and trackers, footnotes and Swagger from several vendors.

  • Panels, expands, tabs, dividers, statuses, page trees, activity streams and news, which convert to native Confluence elements rather than to Capable macros.

  • Numbered headings from two different vendors.

The wizard, the options, and the per-app detail are documented in the Migration space.


#A few things worth knowing

  • Migration writes a new page version, so every change is reversible from page history.

  • Some macros from other vendors are detected and reported rather than converted. The migration space lists which.

  • Run a pilot space first. It takes about an hour and shows you what will happen to your own content.



Do not rebuild the pages. Convert them.