Excerpt Include Macro

Add the Excerpt Include macro to display the contents of an Excerpt macro on another page. 

This is great single sourcing important information. For example you could provide the contact details and dates from each project page on a summary page. When the info is updated in the excerpt, it will flow though to all the other places it is used.

This is a two-step macro. You need to add the Excerpt macro to another page, before you can use the Excerpt Include macro.

On this page:

The example below shows an example of an Excerpt Include macro as it appears in the editor, and as it would appear to someone viewing the page. We have set the options to show both the title of the page and the panel surrounding the content.

  1. The Excerpt Include macro as it appears in the editor
  2. The Excerpt Include macro as it appears when viewing the page

The content is being pulled from a Excerpt macro on a page called 'reusable note'. 

Add this macro to your page

To add the Excerpt Include macro to a page:

  1. Unable to render {include} The included page could not be found.
  2. Choose Excerpt Include from the Confluence content category.
  3. Enter the title of the page containing the Excerpt macro you want to include. 
  4. Choose Insert

You can then publish your page to see the macro in action. 

If the page contains more than one Excerpt macro, the Excerpt Include macro will display the contents of the first one on the page.  It can't display content from multiple Excerpt macros on the same page. 

Want to show more than just an excerpt? The Include Page Macro allows you to include the entire contents of another page.


Change the macro parameters

Error rendering macro 'excerpt-include'

User 'null' does not have permission to view the page.

Here's a list of the parameters available in this macro. 

Parameter

Default

Description

Page Containing the Excerpt
(default-parameter

none

Type the name of the page that contains the excerpt to be displayed. You can use an excerpt from a page in the same space or another space in the same wiki.

When you type the name of the page into the Excerpt Include macro dialog, Confluence will offer a list of matching pages, including those from other spaces.

Alternatively, you can type the space key followed by a colon (:) and the page name, like this:

SPACEKEY:Page name

This parameter is unnamed in wikimarkup.

Remove Surrounding Panel
(nopanel)
 

false

Determines whether Confluence will display a panel around the excerpted content. The panel includes the title of the page containing the excerpt, and the border of the panel. By default, the panel and title are shown.

Error rendering macro 'excerpt-include'

User 'null' does not have permission to view the page.

Other ways to add this macro

Add this macro as you type

Unable to render {include} The included page could not be found.

Add this macro using wiki markup

Unable to render {include} The included page could not be found.

Macro name: excerpt-include

Macro body: None.

{excerpt-include:My page name|nopanel=true}
Last modified on May 4, 2020

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.