Versions Compared

Key

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

Create the actual content with the MultiExcerpt macro and then reproduce it with the MultiExcerpt Include macro. Follow the following steps to create and reproduce content:

  1. Create the actual original content with the MultiExcerpt macro.

  2. Reproduce the content across pages and spaces using the MultiExcerpt Include macro.

...

The following table provides you with a description of the parameters for the MultiExcerpt macro:

Parameter

Mandatory

Description

Name

(tick)

Specify a name for your MultiExcerpt content.

Fallback permission handling

(error)

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, a.k.a. "app user", exists for 3rd party apps like the MultiExcerpt app. 

When "Fallback permission handling" is enabled for a MultiExcerpt then, ONLY for situations where the user cannot be found, the app user will be used to access the excerpted content when a MultiExcerpt Include macro requests it.

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 Jira Service Desk (JSD).  Due to Atlassian bugs, users not in your basic profile in JSD will be unable to see content included via a MultiExcerpt Include.

Hidden

(error)

When the page is published, this option allows you to hide the MultiExcerpt content. 
Check this box, if you only want the MultiExcerpt content to appear when the page is in edit mode.

MultiExcerpt macro

To create the MultiExcerpt macro, perform the following steps:

  1. Create a new page or go to Edit the page where you want to create MultiExcerpt content.

  2. Type / or click the + icon and type MultiExcerpt.

    Image Removed

  3. Select MultiExcerpt macroand Click Insert.

    browse-multiexcerpt.pngImage Added

  4. The Insert MultiExcerpt window is displayed.

    Image Removed

    Specify a name for the MultiExcerpt content and click Insert.

    insert-multiexcerpt-20240323-111052.pngImage Added

  5. The MultiExcerpt key is displayed on the page.

    Image Removedinsert-multiexcerpt1-20240323-111457.pngImage Added

  6. Copy and paste the content, or you can create new content inside the macro body. You can add text, images, Informational boxes, Flow Boards, JIRA issues, and more.

    Image Removedinsert-multiexcerpt3-20240323-112521.pngImage Added

  7. Click Publish.

Note

  • 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, click here.

  • 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.