Confluence DC -> Cloud Migration & Forge: Broken Macros

Atlassian encourages migrating customers to from DC to Cloud and developers to Forge.

However, for Confluence macros the migration from DC->Cloud with Forge is harder / breaks the migration, at least as far as we can tell.

There are 3 issues I’ve noticed: Missing hidden macros, the missing legacy editor support and strange layout behaviors.

  1. Missing ‘hidden’ macros: We used a ‘hidden’ macro in the Connect app to support migrated pages. The idea is to still show migrated content, but disallow creating new content with the in the ‘DC style/configuration’.
    So, we need either:

    • Have some alias functionality, to support the old ‘DC macro’ key and use the same macro.
    • Or Still have a way to mark a macro as hidden. To avoid confusion an dissallow creating ‘old DC style’ macros.
      This seams missing, or am overlooking this options in the documentation.
  2. When migrating a page from Confluence DC → Cloud, it starts of in the ‘legacy’ editor. In the legacy editor, the Forge macro is not shown! So, it does look like the migration failed / the macro is broken. Only converting the page to the new editor will reveal the macro.

  3. Once the page is converted to the new editor, the macro does show up. However, it has a weird narrow layout. Only coping, deleting and pasting the macro in seems to fix the layout. Not clear to me what causes this odd layout.

The summary: At the moment it seems that we have to keep the ‘migration support’ macro on the Connect side. However, that won’t last long, as we do not want to support a extra Connect edition of the macro for the migration.

So my hope:

  • These issues get fixed?
  • There is some other way to support the migration without large efforts.

2 Likes

Thanks for the heads up. It sounds like we will need to pause our efforts to migrate our app from Connect on Forge to Forge Native as a full migration would harm our efforts to support Atlassian with customer DC-> Cloud migrations.

2 Likes

Just another voice in this thread. We were planning to fully migrate one of our connect apps to Forge, but because it is an app that still gets quite a few dc → cloud migrations, with many pages stuck on the legacy editor for ages - we decided to not bother migrating to forge until its fixed.

Specifically this issue:

  1. When migrating a page from Confluence DC → Cloud, it starts of in the ‘legacy’ editor. In the legacy editor, the Forge macro is not shown! So, it does look like the migration failed / the macro is broken. Only converting the page to the new editor will reveal the macro.

Caused us to not migrate to Forge.

4 Likes

Sharing a ticket raised to track this blocker. Please add your vote if you are also affected or blocked by this limitation.