Create
cancel
Showing results for 
Search instead for 
Did you mean: 
Sign up Log in
Celebration

Earn badges and make progress

You're on your way to the next level! Join the Kudos program to earn points and save your progress.

Deleted user Avatar
Deleted user

Level 1: Seed

25 / 150 points

Next: Root

Avatar

1 badge earned

Collect

Participate in fun challenges

Challenges come and go, but your rewards stay with you. Do more to earn more!

Challenges
Coins

Gift kudos to your peers

What goes around comes around! Share the love by gifting kudos to your peers.

Recognition
Ribbon

Rise up in the ranks

Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!

Leaderboard

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,455,644
Community Members
 
Community Events
175
Community Groups

Struggling with Excerpt Include Macro

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? 

Screenshot 2022-11-30 115520.png

2 answers

1 vote

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.

0 votes
Trudy Claspill Community Leader Nov 30, 2022

@Amy Blakemore 

Welcome to the community.

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

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 Community Leader Dec 09, 2022

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.

Screen Shot 2022-12-09 at 6.02.32 PM.png

 

After selecting the macro it looks like this:

 

Screen Shot 2022-12-09 at 6.06.34 PM.png

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

Screen Shot 2022-12-09 at 6.03.01 PM.png

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.

Screen Shot 2022-12-09 at 6.03.21 PM.png

 

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

Screen Shot 2022-12-09 at 6.16.50 PM.png

 

 

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

 

Screen Shot 2022-12-09 at 6.09.46 PM.pngScreen Shot 2022-12-09 at 6.09.57 PM.png

 

Fill in the page where you put the Excerpt macro.

Screen Shot 2022-12-09 at 6.10.15 PM.png

 

Fill in the name you gave the Excerpt macro

 

Screen Shot 2022-12-09 at 6.10.58 PM.png

 

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

Screen Shot 2022-12-09 at 6.11.11 PM.png

 

 

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

Screen Shot 2022-12-09 at 6.11.21 PM.png

 

Then save the page and it displays like this:

Screen Shot 2022-12-09 at 6.15.39 PM.png

Suggest an answer

Log in or Sign up to answer
DEPLOYMENT TYPE
CLOUD
PRODUCT PLAN
STANDARD
TAGS

Atlassian Community Events