How to link to page with a colon in the page title?


we are writing our software documentation in Confluence.

Some Confluence pages need a colon ":" in their page title. 

And sometimes it is necessary to set a link to such a page from another page. When I try to do so, Confluence says, that it does not recognize the part in front of the colon as a valid spacekey (which is correct).

How can I even so link to such a page (except of renaming the targe page)?


Thanks in advance


3 answers

1 vote

I'm afraid you can't - the : is used by Confluence to separate Space:Pagename so, although you can use it in a page name, it can't be referred to by the internal linking system.

I discovered that this can work if you use the "Advanced" tab for editing the link, and include the Space ID in the link.  It seems to know the first colon separates the link from the page, and the second colon is part of the page name.

If you go back to the link editor, it will forget that you gave it a space name explicitly (maybe only when it's the same space as the space of the page you're editing?) and you have to type it back in each time you edit.

To link to an auto-generated anchor (e.g. from a Table of Contents) on the target page, you can append "#" and the portion of the named anchor that corresponds to the header of the section you're linking to.  This means stripping off the portion of the named anchor that corresponds to the name of the page itself.

Example: I'm linking to

I need to insert 

  • FOO:WARP: WindLogics Archive of R Packages#ConfiguringaGitLabbuildforanRpackage

as the Link in the Advanced link editor, and keep prepending "FOO" every time I subsequently edit the link.

Tested using Confluence 6.1.1.

Helpful, Ken! Using Confluence 6.6.7, I was actually able to accomplish this by prepending just a colon to the anchor link (no space name required).

By "link" are you referring to a hyperlink or include page?

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Mar 12, 2019 in Confluence

Confluence Admin Certification now $150 for Community Members

More and more people are building their careers with Atlassian, and we want you to be at the front of this wave! Important Dates Start the Certification Prep Course by 2 April 2019 Take your e...

1,295 views 2 13
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you