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

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


1 badge earned


Participate in fun challenges

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


Gift kudos to your peers

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


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!


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

Atlassian Community Events