Confluence pages with too many embedded attachments

This insight checks whether any of your pages exceed the recommended number of embedded attachments.

Too many embedded attachments can affect performance of a particular page, but not the entire space. The affected pages will most likely work very slowly or not load at all. Experience for users viewing and editing the page is degraded

What are embedded attachments?

Embedded attachments are attachments added inside of macros. For example, if you add an image into a table cell, it's counted as an embedded attachment. An image or file added on the plain page wouldn't be counted.

Embedded attachments take more effort to process that's why we include them in a separate guardrail.

What's the recommendations?

It really depends on how important the content is, so you'll first need to review the affected pages. In general, we recommend deleting and archiving pages that exceed the guardrails and starting fresh. However, if the content and attachments are important and still used, you can split the page into smaller pages to go below the limit and make them optimal. 

Review affected pages

When viewing this recommendation from the dashboard, select the Download page list.

The downloaded CSV file includes:

• Page URLs of affected pages

• Embedded attachment count for each page

Archive pages after migration

After you migrate to Confluence Cloud, archive the affected pages in bulk.

Archive content items in Confluence Cloud

Split page content into multiple pages

You'll need to manually split your page into multiple smaller child pages so that each of them is below the limit of current attachments.

How to split the page

This will depend on your content. Usually, you can find some high-level categories – for example the sections from your original page or the areas related to different attachments. Review the content on your page and organize it into categories.

Splitting the page

Once you know the categories, make multiple copies of the original page, and then remove redundant content and attachments.

Linking the child pages

After your child pages are ready, you can link them for easy access on the original page by using the Children display macro. It will automatically show and refresh any child pages nested under the parent page.