User guide
If you plan to migrate to the Cloud, ensure you do not lose your data/configurations. Check out the Migration guide for information on how to migrate the app’s data to Cloud. Contact our support team if you have any questions.
Overview
The MultiExcerpt app performs similarly to the excerpt macro, allowing for excerpts from multiple spaces. Features of the MultiExcerpt app include:
Ability to seamlessly transfer content between multiple pages and spaces
Reduces the need for rewriting boilerplate documentation
It can be transferred inline with the current content or a resizable block
MultiExcerpts can contain informational boxes, flow boards, and Jira issues
MultiExcerpts can render inline comments from excerpted content
Allows admin to turn off visibility of inline comments for anonymous users (not possible using Confluence permissions)
Enables users to toggle the visibility of inline comments on a page
The following is for the MultiExcerpt Data Center. MultiExcerpt Cloud information can be found here.
User guide
The MultiExcerpt function is a two-step process involving both macros:
Creating the MultiExcerpt key - the text you want to multiply and display in various locations.
Inserting the MultiExcerpt Include to display the key text.
Create the MultiExcerpt key
Select the MultiExcerpt macro.
Name the MultiExcerpt, then click Insert.
The MultiExcerpt key is displayed on the page.
Add the text you want to display inside the MultiExcerpt macro body in multiple locations.
Insert the MultiExcerpt Include Macro
Select the MultiExcerpt Include macro. To include the MultiExcerpt inline with the current content, select MultiExcerpt Fast Include (Inline). Or, select MultiExcerpt Fast Include (Block) to insert the content as a resizable block.
Add where the MultiExcerpt key is located (Space and Page) and its Name, then click Insert.
The MultiExcerpt Include block displays while the Confluence page is in edit mode. In view mode, your text displays exactly how it looks in the MultiExcerpt key.
Using the @self keyword for the Page with Excerpt parameter
The @self feature is helpful in page templates employing the MultiExcerpt-Include macro. It allows you to incorporate a MultiExcerpt from the template directly. Subsequently, when representing pages using that template, the MultiExcerpt-Include seamlessly operates without modifying the page title within the Page with Excerpt parameter.
When creating a new page, and you include both MultiExcerpt and a MultiExcerpt-Include at the same time. Before you published the page, you might notice that the drop-down menu for selecting a MultiExcerpt Name in the MultiExcerpt-Include menu doesn't show any names. This happens because the system can't see the new page yet since it has not been published.
Here's what you can do:
If you're adding the MultiExcerpt-Include in the first version of the page (version 0), you can manually type the name of the MultiExcerpt in the MultiExcerpt Name box.
Alternatively, you can add the MultiExcerpt, publish the page, and then go back to edit it. When you add the MultiExcerpt-Include, the drop-down will show the names because the page has been published.
The system can't see a MultiExcerpt you just added until the page is published. So, either type it in manually when adding or publish the page first and then add it to see the drop-down names.
Find MultiExcerpt Includes
You can search for all the locations where a specific MultiExcerpt has been included.
Navigate to the page where the MultiExcerpt is located.
Click Edit (page edit mode) to view the MultiExcerpt macro.
Click the MultiExcerpt macro.
Click Find includes - this space/Find includes - selected space.
The list of pages that include MultiExcerpt are listed. Click any link to go to that page.
Need support? Create a request with our support team.