Struggling with Excerpt Include Macro

[Amy Blakemore]

Hi! I'm trying to use the Except Include Macro to mirror a section of content from one Confluence page onto another, and having some issues. I know I first have to set up an Excerpt Include (see below), but I saw in the online instructions to copy and paste my content into the Excerpt Include. This means that when the content on the page itself is updated, the updated not flow into the new page where I want to insert the Excerpt Include Macro. There is probably something obvious that I am doing wrong, but I am stuck! How can I set up an Except Include so any updates to the section flow automatically to where I embed the macro? 

[Nic Brough -Adaptavist-]

Welcome to the Atlassian Community!

No, that's not quite how to use it.

The way to use this is to do things like the "server summary" I used in my last place a lot:

Page 1: 

Server XYZ-42-9b
Some content about hardware 
{excerpt}. a bit about what it is running {excerpt}
Some content about location and support

Page 2: 

Server ABC-123
Some content about hardware 
{excerpt}. a bit about what it is running {excerpt}
Some content about location and support

Page 3: 

Server XYZ-1
Some content about hardware 
{excerpt}. a bit about what it is running {excerpt}
Some content about location and support

Page 4:

some services and server info
{excerpt-include: Server XYZ-42-9b}
{excerpt-include: Server ABC-123}
{excerpt-include: Server XYZ-1}

Whenever I change the text inside any of the {excerpt}{excerpt} blocks, the next time page 4 is rendered or refreshed, the text in the three include blocks will be refreshed with the data in the source pages.

[Leila Paul]

Hi,

I am having problems with the table of contents AFTER adding the new page with the excerpt include macro. The content from the other page won't appear. The headers will be hidden from the table of contents. May you please help me out here?

Thank you!!

[Trudy Claspill]

Hello @Leila Paul 

Welcome to the Atlassian community.

Please start a new Question for your request and provide all the relevant information about your environment. It will also be helpful if you can provide screen images of both pages.

[Trudy Claspill]

@Amy Blakemore 

Welcome to the community.

Just curious, can you provide a link to the online instructions from which you were getting that info?

[Amy Blakemore]

I was looking here! https://support.atlassian.com/confluence-cloud/docs/insert-the-excerpt-macro/

It just says "Add your content inside the Excerpt macro placeholder in the page. Most of the formatting options can be used, and elements in the toolbar can be inserted into the macro." It doesn't really specify HOW to add the content, so I am clearly doing something wrong. I guess I need to put {excerpt} around the content I need on the page itself? I wish there was a quick video...

[Trudy Claspill]

Lots of people, and Atlassian team members, create videos for how to do things and post them on YouTube. I found this one about Excerpt/Excerpt Include macros, though it looks like it may be for Confluence Server, or an older version of Confluence Cloud.

https://www.youtube.com/watch?v=hUWkxXQKO9o

Hopefully these steps below will help you.

On the page that has the content you want to mirror, while editing the page, you insert the Excerpt macro.

After selecting the macro it looks like this:

Then you put your content within the boundaries of the Excerpt macro.

If you already have the content in your page, you can select that content, cut it, and paste it within the boundaries of the macro.

Then you give the Excerpt macro a name. This is in a pane displaying on the right side of the page.

Save the page. The Excerpt does show anything special when viewing the page.

Next, in the page where you want to mirror that content, edit the page and add the Excerpt Include macro.

Fill in the page where you put the Excerpt macro.

Fill in the name you gave the Excerpt macro

Click the preview button to make sure you got the Excerpt Name right. If you did it will show you the Excerpt macro.

Save the Excerpt Include macro configuration. It will display like this when you are still Editing the page.

Then save the page and it displays like this: