Multiple Excerpts & Include Macros

Multiple Excerpts & Include Macros add-on for Confluence allows users to add excerpts in Confluence pages with unique name or key. Unlike default excerpt macros, this extension makes it possible to define and include more than one excerpt per page by identifying excerpts with their keys(names).

With Multiple Excerpts & Include Macros, you can treat excerpts as content blocks which can be re-used anywhere in Confluence, across multiple spaces.

Install

If you haven't installed, please install from Atlassian Marketplace here: https://marketplace.atlassian.com/apps/1224825/multiple-excerpts-include-macros?hosting=cloud&tab=overview

User Guide

Once installed, you can start using this app. It works like default 'Excerpt and Excerpt Include' macros, but with extra flexibility.

  • Open the page editor window and type / followed by 'Multiple Excerpts'.

  • Add excerpt with content you want to reuse in other pages and spaces.

Define excerpts using Multiple Excerpts and Include Macros
Define excerpts using Multiple Excerpts and Include Macros

You can add as many excerpts as you need in a single page. Just make sure that the key is unique across your excerpts in the page.

Once excerpts are defined, they can be treated as content blocks and used anywhere.

  • Go to another page where you want to include this content and open 'Multiple Excerpts Include'.

  • Select the page where the excerpt is located and enter the excerpt key. If the key is not found, it will give you a helpful message.

Include content block using Multiple Excerpts and Include Macros
Include content block using Multiple Excerpts and Include Macros
  • Save the page and excerpt from other page is now included. You can include as many excerpts you need.

This way, you can reuse contents across Confluence. Say goodbye to redundant documentation and stay organized and keep information up to date. Try Multiple Excerpts & Include Macros out today!

Known issues

  • Use of colon ( : ) in page title

You might face issues when using colon ( : ) in page title. This is problematic because Confluence uses colon to differentiate between space and page title when dealing with cross space contents. For example, if you have page title ‘Everest: The highest mountain!', Confluence considers 'Everest’ as space key and rest as page title.

Suggestion: It’s best to not use colon ( : ) in page title. You are free to use any other letters or symbols.

  • Intermittent failure to load included content

If you include too many excerpts in a page, e.g. more than 50 excerpts, you might notice intermittent failure when loading the page. This is caused by Confluence API rate limit, as the add-on uses Confluence REST API to retrieve excerpts. Unfortunately, Atlassian has not disclosed exact metrics when the rate limit is enabled.

Suggestion: We suggest users to limit include macros per page to less than 50, ideally not more than 20. For example, you can split the large page into multiple child pages, so the number of macros in each page remains under certain limit.