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
Atlassian Community Anniversary

Happy Anniversary, Atlassian Community!

This community is celebrating its one-year anniversary and Atlassian co-founder Mike Cannon-Brookes has all the feels.

Read more
Community showcase
Kesha Thillainayagam
Posted Apr 13, 2018 in Confluence

We want to hear how your non-technical teams are using Confluence!

Hi Community! Kesha (kay-sha) from the Confluence marketing team here! Can you share stories with us on how your non-technical (think Marketing, Sales, HR, legal, etc.) teams are using Confluen...

380 views 21 10
Join discussion

Atlassian User Groups

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

Find a group

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

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you