Showing results for 
Search instead for 
Did you mean: 
Sign up Log in
It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

How to use "include" properly

Hello everyone.
I have a question related to "Include" Option. My task is to create a space with Education Materials for my team. We have already a lot of educational pages but they are spread across other spaces. Can I use "include" option but also edit it in my document? Or once I use the include option, the only way to make changes in my document is to change the initial document?

Basically, I want to automate updates coming from another space to this new Educational space, but also I want to keep the ability to edit it the way I need. 

Thank you in advance. 

1 answer

1 accepted

2 votes
Answer accepted

The include macro will always reflect the source. If you edit the source, then it will be reflected on the page including the content. It sounds like you want to copy and past to bring in that content and edit it.

BUT you can have local content on the page between your includes.

The other approach is to use the excerpt macro. That would allow you to share common content between pages, and local custom content.

Thank you for your reply. I tried also to use excerpt macro but it seems like it is not working. 
I am adding a screenshot. Sorry for Russian, but the main issue is that once I select this Macro, I am not able to select the area which I need to be included. Basically, it just includes only "Educational Materials" text and that's all 

Thank you in advance012.PNG

The excerpt macro is a little tricky the first time you try it, but it does work.  The include part needs a pointer to a page, upon which you have flagged an excerpt.

Imagine Page 1's editable content is:

Alice went down a rabbit hole
{excerpt} Kate is short for Bob {}
R.I.P Charlie


Then Page 2's editable content is:

Alice's second name is Lidell
{excerpt-include} Page 1 {}
We miss Charlie

Then Page 2 will render

Alice's second name is Lidell

Kate is short for Bob

We miss Charlie

Like # people like this

I still do not get it fully. So I should put {excerpt} at the initial page and put some text in it and only after this I will be able to include this text into another page, right?
So it should look like this?

Sorry, I am not a technical guy at all. :)

Nothing to apologise for!  It's unfamiliar, so you're asking!

But you are exactly right.  On the page you want a part of, you surround the part you want in the {excerpt} macro.  Then on the page you want to see it on, you use {excerpt-include} and tell it what page you want it to look at for the excerpt.

If it helps, I suspect the answer to the next question a lot of people ask might explain a bit more too.  Most people will ask something about having multiple excerpts on a page - you can't do this.  The native function only works for a single excerpt.  If you want to take many from one page, you need an app to provide another macro!

But you can make pages that pull excerpts from others.  I've been known to write pages that are as simple as:

Include: Server overview

Excerpt-include:  Server 1 details

Excerpt-include:  Server 2 details

Excerpt-include:  Server 3 details


With the three server pages being a load of stuff about each different server, but having a brief summary of the important bits of it in the excerpt

Like # people like this
Bill Bailey Community Leader Dec 02, 2021

@Nic Brough _Adaptavist_  with the assist!

Like Arseniy Sidorov likes this

Now I got it. Thank you!

Suggest an answer

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

🏠 Say hello to the new Confluence Home!

Hi Atlassian Community, My name is DJ Chung, and I’m a Product Manager on the Confluence Cloud team. Today, I’m excited to share a new and improved version of Home. The new Home helps you ...

43,917 views 33 137
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