Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This article contains information about migrating HTML macro content from server to cloud. For existing customers, migrating content of the HTML for Confluence HTML macro content to cloud was discouraged not allowed due to certain Atlassian Confluence cloud limitations as listed in the HTML-362 Jira issue. Due to this issue, it was possible to have there were issues in rendering HTML content on pages and/or templates that used the HTML macro of the HTML for Confluence app. 

...

This is the number of pages and/or templates that require the HTML macro name change. 

Image Added

Tip
titleHow to confirm if all pages and/or templates are updated?

After this updation process is completed, you can revisit the Macro usage page to verify that all the required pages and/or templates that use the HTML macro are updated.

...

  1. Select  > Manage apps.
  2. Either search for HTML for Confluence or scroll to Bob Swift Configuration, and click HTML to view app configuration. 

    Tip
    titleTry this for older Confluence versions!

    Navigate to CONFLUENCE ADMINISTRATION > Settings > ATLASSIAN MARKETPLACE > HTML.

    This opens the HTML for Confluence Configuration page.

  3. Select <tab name> Migration to Confluence Cloud. This tab displays some information about the HTML macro usage in your instance similar to the following screenshot:
    <screenshot>Image Added
  4. Click Update pages to start the updation process. 

    Note
    • Leaving this page does not disrupt the updation process as it runs in the background.

    • This process can be run as many times as required to migrate macro name in the pages and templates.

    • Every page or template that is processed shows up as an update in Page history.


  5. After the updation process is completed, the macro usage information on the page is updated and these updates can be verified through the Macro usage page as mentioned in the previous section. 

Info

It is recommended to Administrators must still run the Confluence Migration Assistant to complete the migration process from server to cloud. This is because the updation process does not actually migrate the HTML contents, but simply resolves the mismatch of the HTML macro names used in server and cloud. 

...