Issue Summary

A layout distortion issue occurs when a page containing a legacy insert excerpt (excerpt-include) macro is converted from the Legacy Editor to the Cloud Editor. The problem appears only in the customer’s migrated environment and cannot be reproduced in Atlassian’s internal test environments.

This indicates that the root cause may be related to:

1. the conversion handling of legacy excerpt-include macros during migration or editor transition.
2. data characteristics specific to the customer’s CCMA-migrated content.

In the affected pages, the Cloud Editor conversion produces an incomplete excerpt-include macro structure that lacks required Cloud-native attributes, resulting in layout collapse in Edit mode.

Steps to Reproduce

(These steps reproduce the issue {}only in the customer’s environment{}.)

Step 1
Open a migrated page originally created in the Legacy Editor that contains a legacy insert excerpt (excerpt-include) macro inside a layout section.

Step 2
Verify that in the Legacy Editor, the page renders normally in both View and Edit modes.

Step 3
Convert the page to the Cloud Editor using “Convert to cloud”.

Step 4
After conversion, open the page in Edit mode.
The layout collapses, particularly within the layout-section containing the excerpt-include macro.

Step 5
Check the storage format of the converted macro.
The macro lacks Cloud Editor–specific attributes such as:
data-layout

ac:local-id

This indicates incomplete Cloud Editor transformation.

Step 6
Delete the legacy excerpt-include macro, re-insert a new excerpt-include macro using the Cloud Editor, and configure it to reference the same source page.
The page layout now renders normally in both View and Edit modes.

Expected Results

Pages containing legacy excerpt-include macros should be reliably transformed into Cloud-compatible macro structures during editor conversion or CCMA migration.
The page layout should remain stable in Edit mode regardless of its origin.

Actual Results

in the customer’s migrated environment:

• The converted excerpt-include macro lacks required Cloud Editor metadata (e.g., data-layout, ac:local-id).
• The macro is treated as legacy content and fails layout calculations inside ac:layout-section.
• Edit mode collapses the layout.
• View mode displays normally.
• Re-inserting the macro regenerates proper Cloud-native attributes, resolving the issue.

Internal replication attempts in Atlassian test sites (fresh pages, manually created legacy pages, and various conversion patterns) did NOT reproduce the issue, suggesting a customer-specific data condition introduced during migration.

Workaround

Delete the legacy excerpt-include macro and re-insert a new excerpt-include macro using the Cloud Editor.
This forces regeneration of Cloud-native macro attributes and restores layout behavior.