Versions Compared

Key

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

...

  1. Create the MultiExcerpt key containing the content you want to leverage by reusing/displaying it in other locations. To learn more about how to create creating MultiExcerpt content, click here.
    The following are the available MultiExcerpt macros:

    1. MultiExcerpt Macro

    2. MultiExcerpt (Advanced)

    3. MultiExcerpt (Advanced Inline)

  2. Inserting the MultiExcerpt Include to reuse/display the excerpted content. To learn more about how to reuse MultiExcerpt content, click here.
    The following are the available MultiExcerpt Include macros:

    1. MultiExcerpt Include

    2. MultiExcerpt Include (Advanced)

    3. MultiExcerpt Include (Advanced Inline)

...

As an added complexity, many behaviours behaviors of new/fabric pages are undesirable and inconsistent with the behaviours behaviors of legacy pages. Sometimes, 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 "Advanced" versions of the macros, but beware that they come with some limitations. For example, suppose you nest a Confluence Table macro inside of a MultiExcerpt. In that case, table sorting will not work in the "Advanced" version because the iframe containing the content cannot access the CSS styling of the containing page. Confluence's Table macro depends on the CSS styling of the containing page. In such a case, you must choose the more straightforward, but not as performant, "static" macros.

See Confluence Cloud documentation for information on telling the difference between an old and a new page. 

...

Inline

Block

Inline allows the excerpt to be inserted in line with the content around it.

Block allows the insertion of content into separate blocks.

Edit mode

View Mode After Saving Page

Edit mode

View Mode After Saving Page

Limitations

Performance

There is a limit on the The number of MultiExcerpt Includes you can use on a single page with satisfactory rendering times is limited. This is due to a combination of the web browser capabilities of web browsers, Confluence, and the MultiExcerpt Include macro.

There are many variables to consider, so there is no specific limit. However, if you are approaching 100 includes on a page, you are probably pushing the limits boundaries 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 and allow even more includes. However, you may want to reconsider your page design if you use a large numbers number of includes on a single page, you may want to reconsider your page design.