MultiExcerpt macros - Data Center
Create content with the MultiExcerpt macro and then reproduce it with the MultiExcerpt Include macro. Use the following steps to create and reproduce content:
Create the original content with the MultiExcerpt macro.
Reproduce the content across pages and spaces using the MultiExcerpt Include macro.
Parameters
The following table provides you with a description of the parameters for the MultiExcerpt macro:
Parameter | Mandatory | Description |
|---|---|---|
Name |
| Specify a name for your MultiExcerpt content. |
Fallback permission handling |
| The Fallback permission handling parameter in the MultiExcerpt macros is used to provide a fallback permission check in some scenarios, such as exposing Confluence content in Jira Service Desk (JSD). A system user or app user exists for 3rd party apps like the MultiExcerpt app. When Fallback permission handling is enabled for a MultiExcerpt, the app user will be used to access the excerpted content when a MultiExcerpt Include macro requests it, ONLY for situations where the user cannot be found. An example of a scenario where it could be necessary to enable it is when using a MultiExcerpt Include on a page that is exposed on JSD. Due to Atlassian bugs, users not in your basic profile in JSD will be unable to see content included using a MultiExcerpt Include. |
Hidden |
| When the page is published, this option allows you to hide the MultiExcerpt content. |
Find includes - this space |
| Lists all the pages in the current space, with include macros that includes this excerpt. |
Find includes - selected space |
| Lists all the pages in the selected space, with include macros that includes this excerpt. |
Find include - all spaces |
| Lists all the pages in all spaces, with include macros that includes this excerpt. Since this will search all spaces available, the search may take time. |
MultiExcerpt macro
To create the MultiExcerpt macro, perform the following steps:
Create a new page or Edit the page where you want to create MultiExcerpt content.
Type / or click + and type MultiExcerpt.
Select MultiExcerpt macro and click Insert.
The Insert MultiExcerpt window is displayed. Specify a name for the MultiExcerpt content and click Insert.
The MultiExcerpt key is displayed on the page.
Copy and paste the content, or create new content inside the macro body. You can add text, images, informational boxes, flow boards, Jira issues, and more.
To search for locations where a specific MultiExcerpt has been included, select the Find Includes option that fits your search. For a detailed explanation of each option, review the Parameters section.
Click Publish.
MultiExcerpt (Advanced Inline) and MultiExcerpt (Advanced) are special cases macros. These macros are solutions to rendering issues in the cloud. To know more about their differences, see difference between MultiExcerpt and MultiExcerptFast.
The process to create these macros is the same as the MultiExcerpt macro.
Make sure you add the respective include macros MultiExcerpt (Advanced Inline) and MultiExcerpt (Advanced) to reproduce the content.
Need support? Create a request with our support team.
