The MultiExcerpt app performs similarly to the excerpt macro while also allowing for multiple excerpts from multiple spaces.
The MultiExcerpt function is a two-step process involving two macros, both of which come with purchasing the MultiExcerpt app from the Marketplace:
Create the MultiExcerptkey containing the content you want to leverage by reusing/displaying it in other locations. To know more on how to create MultiExcerptcontent, click here. The following are the available MultiExcerpt macros:
MultiExcerpt Fast Excerpt (Inline)
MultiExcerpt Fast Excerpt (Block)
Inserting the MultiExcerptInclude to reuse/display the excerpted content. To know more on how to reuse MultiExcerpt content, click here. The following are the available MultiExcerpt Include macros:
MultiExcerpt Fast Include (Inline)
MultiExcerpt Fast Include (Block)
Difference between MultiExcerpt and MultiExcerptFast
for legacy pages, you should prefer the "Fast" macros
for new "fabric" pages you should prefer the regular macros (MultiExcerpt, MultiExcerpt Include) because there is no speed advantage in the Fast macros on new pages and dynamic macros have limitations.
In a past Confluence version, Atlassian made changes to the rendering of pages which slowed down page loading for pages with several MultiExcerpts or MultiExcerpt Includes. MultiExcerpts are "static" macros and, for pages created with the old legacy page editor, page rendering was blocked until all "static" macros were ready. We resolved this issue by implementing the MultiExcerpt Fast Excerpt and MultiExcerpt Fast Include macros within the MultiExcerpt app. The "Fast" versions are based on dynamic Connect app technology that does not block page rendering for pages created with the old legacy page editor.
Fast forward to today and Atlassian has introduced a new page editor (a.k.a. the fabric page editor). Pages created with the new page editor do NOT block rendering for "static" macro processing. It is not necessary to use the "Fast" (dynamic) versions of the MultiExcerpt macro for new/fabric pages. It may be preferable to stick with the "static" MultiExcerpt and MultiExcerpt Include macros for new/fabric pages because the Fast macros have some limitations due to the nature of dynamic macros (rendered in an iFrame).
As an added complexity: there are many behaviours of new/fabric pages that are undesirable and inconsistent with the behaviours of legacy pages. In some cases, you may be forced to use a legacy page to get a feature or behaviour that has not been implemented or does not work in the new/fabric pages. When you are forced to use a legacy page you should prefer the "Fast" versions of the macros but beware that they come with some limitations: for example, if you nest a Confluence Table macro inside of a MultiExcerpt then table sorting will not work in the "Fast" version because the iframe containing the content does not have access to the CSS styling of the containing page and Confluence's Table macro depends on the CSS styling of the containing page. In a case like that, you must choose the simpler, but not as performant, "static" macros.
For information on how to tell the difference between an old page and a new page, see Confluence Cloud documentation.
The MultiExcerpt Fast macros provide you with two different options inline and block. The following table provides the differences between inline and block macros:
Inline allows the excerpt to be inserted in line with the content around it.
Block allows the insertion of content into separate blocks.
View Mode After Saving Page
View Mode After Saving Page
There is a limit on the number of MultiExcerpt Includes that you can use on a single page with satisfactory rendering times. This is due to a combination of the capabilities of web browsers, Confluence, and the MultiExcerpt Include macro.
There are many variables to consider so there is no specific limit but if you are approaching 100 includes on a page you are probably pushing the limits of your web browser, Confluence, and the MultiExcerpt Include macro. If you are approaching 150 you are probably past the limit.
We are currently considering approaches to increase the performance of the MultiExcerpt macro to allow even more includes. However, if you are using large numbers of includes on a single page then you may want to reconsider your page design.