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
Posted Feb 06, 2019 in Confluence

Try out the new editing experience

Hi team, I’m Avinoam, a product manager on Confluence Cloud, and today I’m really excited to let the Community know that all customers can now try out the new editing experience and see some of the ...

1,436 views 110 8
Join discussion

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