Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

Excerpt include makro with "excerpt name" set, does not find the excerpt in page


We are using "Excerpt" makros in several pages and using "Excerpt include" works fine in any other page, as long as there is only one excerpt in the referenced page and you are not using the "Excerpt Name".


The new functionality of setting an "Excerpt Name" per excerpt should allow to include a specific excerpt, but as soon as you set the "Excerpt Name" in the "Excerpt include" makro, it doesn't find anything in the referenced page (Page Containing the Excerpt).


I don't think I am misunderstanding the documentation of the Excerpt Include:

"Allows you to identify this macro so that you can add multiple Excerpt macros to one page and use a specific one on another page using the Excerpt Include macro."


Is this a known bug and when will this be fixed?

1 answer

1 accepted

2 votes
Answer accepted

I think you have understood all of the docs up until the bit where it fails to be clear.

You are absolutely right that any one page can only have one working section surrounded by the excerpt macro. 

Confluence only looks at one excerpt macro on a source page.  Put more than one into a page, and it fails (it used to just complain that your page data was junk, now it lets you do it, but I don't know how the code decides which bit to read if you do use it more than once)

It is not really a "bug", it is a weak feature.  Atlassian has not implemented a decent "have many excerpts on one page" function.

This is not unexpected, the "multi-excerpt macro" app solves the problem, really well, and Atlassian tends not to build in functions that their partners are providing solutions for.

Thanks for your reply. Sad to hear such a basic feature is still not available by default makros.

What is the point to name the excerpt if by page it only accept one excerpt. We want to use mark multiple sections of a page as excerpts to be call up on other pages and that was not possible.

Looks like we  need to break down the reference document into multiple pages so we can create the excerpts.  

Suggest an answer

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

An update on Confluence Cloud customer feedback – June 2022

Hi everyone, We’re always looking at how to improve Confluence and customer feedback plays an important role in making sure we're investing in the areas that will bring the most value to the most c...

159 views 1 3
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