It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Confluence Excerpt render or non-render?

Hi. I wonder how Excerpt works in Confluence.

I.e., if I create an excerpt on a page that holds Blog Post Macro. Then I include this excerpt on another page.

Will excerpt fetch the html rendered by the macro or the macro itself, which then will be rendered on

the page where excerpt is included?

3 answers

1 accepted

Hallo KPAH

In summary: The Excerpt Include macro will fetch the Blog Posts macro, and then render it independently on the page.The Excerpt Include macro does not fetch the static HTML from the source page.

In more detail: Let's say page A has the Excerpt macro, which includes the Blog Posts macro. And page B has the Excerpt Include macro.

Page A will display the results of the Blog Posts macro, at the time when page A is rendered, and every time afresh when page A is rendered.

Page B will also the most up-to-date results of the Blog Posts macro, at the time when page B is rendered, and every time afresh when page B is rendered. The display of the results on page B is not dependent on the display of the results on page A.

I hope this answers the question. :)

Cheers, Sarah


The Excerpt Macro, will be used to mark a part of a page's content for re-use. Defining an excerpt enables other macros, such as the Excerpt Include and Blog Posts macros, to display the marked content elsewhere.

You can only define one excerpt per page. In other words, you can only add the Excerpt macro once to a page.

The Excerpt Include macro is used to display 'excerpted' (that is, a segment of) content from one page in another.

Before you can use this macro, the excerpt must have been defined using the Excerpt macro. Note that you can have more than one Excerpt Include macro on a page (although you can have only one Excerpt macro on a page).

I hope this helps.



No it doesn't help, why do you even bother to post that completely irrelevant stuff?

The question is - if I excerpt a macro, and then excerpt-include it, WHAT the excerpt-include get from the original page? The macro code or the html output of the macro?

no one knows

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Confluence

6 Awesome Ways to Apply Trello, JIRA and Confluence to your Project

I attended  Atlassian Summit 2019  and learned a lot from the presenters, attendees and knowledgeable Atlassian product managers. The presentations I attended focused on applying Agile, pla...

4,022 views 15 38
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you