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
4,298,556
Community Members
 
Community Events
165
Community Groups

Insert multiple excerpts from the same page

Hi Atlassian Community,

My name is Sekajipo Taplah, and I am a Product Manager on the Confluence Cloud team. We are constantly listening to your feedback and improving our products to deliver a more valuable experience.

We are excited to announce that we are making the single sourcing of your content more flexible and useful by giving you the ability to create a page that contains multiple Excerpt macros. 

Previously when you added multiple Excerpt macros to a page, only the first one could be referenced on other pages. However, you can now create a page that contains multiple Excerpt macros, AND you can choose which Excerpt you include on other pages by referencing its name.

How can I use multiple Excerpt macros? 

Let's say, you have several legal statements that you need to include in the Confluence pages you publish. You can create one page with each of those legal statements inside their own named Excerpt macro, like Statement one, Statement two, and Statement three.

Whenever you want to include the text from Statement one on other pages, you insert an Excerpt include macro on all the pages where that statement needs to appear. You set up the macro to point to the source page and reference the name given to the macro. If and when the legal statements change, you don’t need to go to every page and edit the content. You go to the source page and edit it once. Thanks to the macros you put in place, the changes made to the source update all the places where you added the Excerpt include macros.

How does this work?

When you see the need to reuse content, you’ll need to:

  1. Insert an Excerpt macro to the page. The content that you want to reuse gets added inside the body of the macro.
    💡 Macros can be found and added to the page using a shortcut like the slash command or by selecting the in the toolbar and inserting it that way.

  2. Give the excerpt a name in the right panel so that you can find that exact content later. This name doesn’t show up to viewers of the page, so it can be a shorthand name that makes sense to you.

  3. Insert additional Excerpt macros as needed.Unknown.png

  4. Publish the page that contains the macros whose content can be reused elsewhere.
  5. Create a new page.

  6. Insert an Excerpt include macro; this macro will pull in the content from the page you pick and Excerpt macro with the name you enter. You can select Preview before saving the macro to make sure you see what you expect. Excerpt Macros are case sensitive so make sure there's an exact match for your names

  7. Select Save to add the macro to your page.

Unknown 3.png

This feature isn’t necessary for all Confluence users, but for those of us who need to create and maintain a lot of content, having a single source for the content that you reuse on multiple pages is much more efficient and accurate.

Feedback or Questions

Don’t forget to let us know any feedback or questions you have in the comments. We’d love to hear your suggestions on how we can make this experience even better for you!

🎉  Special thanks to our talented engineer Niraj Agarwal for bringing this feature to life! 😀

43 comments

Like # people like this

Thanks. However, this didn't work for me. I tried to include two excerpts named "dog" and "cat" and I got this error.

Woohoo!! Finally very excited for this. 

Like # people like this

I got an error but I cannot show it as it's proprietary.

Hi @cnaumann ! Hope all is well!


The feature is case sensitive so double check if its spelled exactly "dog" on the excerpt macro. "Dog" (capitalized) or other variations will not display your content as intended 

Like Niraj likes this

When will this be available for Server/Data Center users?

Like # people like this
Matt Reiner _K15t_ Marketplace Partner Oct 28, 2021

Well this is very exciting!

Like # people like this

Please please please give Data Center this feature as well! 

Like # people like this

Thank you. This is a powerful feature.

Like Andres de Vivanco likes this

I noticed when adding the "excerpt include" to a different page I needed to know the actual source page and then lookup the name of the excerpt macro on the page.  Is there a way to see a list of all the Excerpt Macro's by confluence page somewhere so you can more easily see what is in use?

Like # people like this

So the user has to remember the Excerpt Name? How about listing all excerpts from the Page Containing the Excerpt and let the user choose one? This is not very user friendly.

Like # people like this

When I changed de Excerpt. The excerpts on the other pages didn't change automatically. I had to publish the pages before the change appeared on the page. 

Nice feature! Bur when I try to use bullets or other formatting a scrollbar appears. Seems it only works on text with basic formatting.

Edited: I have tested again and no scrollbars appear. Seems the problem has been fixed :)

Like # people like this

Article has a misspelling. It should say, "How can I use multiple Excerpt macros?" not "How can I use multiple Except macros?"

:)

Like # people like this

It's a great news, thank you! :) 

Like Sekajipo Taplah likes this

Been waiting so long for this!!!!

Like # people like this

This is a killer feature, will it be available on the Server version soon?

Like Jean Siegel likes this

I loved that! Thanks!!! It is very useful. I was expecting something like this, better "summary pages" with this functionality and... I already tried it! Thanks again @Niraj Agarwal  and @Sekajipo Taplah

Like # people like this

is posible include a excerpt in a Jira description or text field?

This is a great feature and one we have been using as a paid plug-in. Can this tool be used to edit the existing multi excerpt include plug-in?

After a quick check, I see that, similar to the Page Properties macro, the new Name parameter is optional.

I do have a few questions @Sekajipo Taplah :

  1. Is there a easy/convenient migration path from the MultiExcerpt Marketplace app for those of us who have been paying for years waiting for Atlassian to release this (most welcome!) improvement?
  2. Will the Excerpt Include macro work (at last) if referencing an Excerpt  within the same page?

Thank you.

PS: Now I really wish the page name displayed in the Surrounding Panel would be –optionnaly– clickable.  Please vote for CONFCLOUD-73160 Make the page name displayed in the Surrounding Panel of the Excerpt Include macro optionnaly clickable.

Amazing!  I've been talking about this feature and waiting eagerly till it came out.  Can't wait to try it.  I'm so happy Atlassian is always thinking ahead in the right direction. 

Excerpts in SSOT:  of course. It's not only going to make the content creation easier but it will also make the Knowledge Transfer User Experience (KTUX) much continuous and fluent like @Patricia Micheloud mentions above kind of "Summary Pages" combining Excerpts and content .   

Great job Atlassian!! You're always right on pace with what we need or even moving faster.  That's awesome. 

I can't wait to try cascading or hierarchies of Excerpt macros as in cascading summaries but with content (hopefully you can invoke them at different levels of a space and from different levels of the same space  @Sekajipo Taplah).  Thanks!

Cheers,

Andy

Like Sekajipo Taplah likes this

Please add this for Server licence users; I've purchased a plugin just to perform this function. 

This is a great feature that adds a lot more possibilities.

Like Sekajipo Taplah likes this

Comment

Log in or Sign up to comment
TAGS
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...

208 views 1 4
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