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

Broken links and includes


I have realized that if I link or create includes of pages that reside in the same space of my page, if the page is moved or copied all links break. It looks like Confluence is trying to fing these pages in the new space.

Has anyone ever seen this? Any solution?



3 answers

Hi all,

Bug confirmed, see ticket below.




@Matteo Gubellini [SoftComply]  According to the doc (, I don't think you can:

- include a page from the space m

- move the included page into another space

without modifying the include macro.


The doc states "If the page or blog post is located in another space, add the space key and a colon in front of the page name. For example, DOC:My page name. The space key is case sensitive."

Have you already tried to prefix the included page with the new space key?


Concerning the links in Confluence, I tend to systematically use the tiny links (press 'k' on any page to have them). It ensures your link never gets broken.


Hope it helps,





Hi @Farid Jaddi ,

Yes I added the space key too, then moved it, but the results are the same.

It seems that if you use the current space, the macro automatically removes the key. I also tried to add it in the XML export, but no luck.



Yes I think it's a limitation of the macro.

I tested it myself and I have the same issue:

- when the included page lives in the same space as the page including the content, the copy 'breaks' the 'include page' macro

- when the included page and the page including the content live in different space, the copy to a different space works.

I think it's worth raising a ticket to Atlassian since the documentation doesn't state this limitation and the behaviour is brittle.


Good luck mate,



@Matteo Gubellini [SoftComply] I've moved many pages within a space and haven't had problems with links being broken. We are using Cloud Confluence in the cloud. So maybe you should log a support request as perhaps it's just affecting your site. 

@Lucy Minato That's very strange. I've just created a new instance and it behaves the same.

  1. Create new space
  2. Create new page with content to be included (page 1)
  3. Create new page and use the include macro with the content of the first page. (page 2)
  4. Copy page 1 into another space.


Sorry @Matteo Gubellini [SoftComply] I misunderstood your problem, I didn't realise you were copying a page to another space. So can't help you ... but hopefully someone else can. 

Suggest an answer

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

Presenter Mode for Confluence is here 🖥 👩‍💻

👋  Hello Community!  My name is Stephanie Zhang, and I’m a product manager on the Confluence cloud team. Today, I’m excited to announce the rollout of  Presenter Mode : a ...

80,049 views 126 302
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