How to force pretty URLs in Confluence?

Hi. When using confluence, I find that pages on the top level of a space do always have "pretty" human-readable URLs, like

However, pages on the second level and below are always references by a cryptic page id, e.g.

Is there a configuration option where I can tell Confluence to use pretty URLs for each and every page? I know that there is a "tiny" URL for each page, but they are also very cryptic.

Many thanks in advance.

6 answers

1 accepted

1 vote
Accepted answer

Please refer to the following KB for more info:'s+Contain+pageId+Instead+of+The+Page+Title

There's actually a feature request for that:

Unfortunately, I am not aware of any workarounds for this as of now. FYI, this has affected our FAQ as well, for example:

One of FAQ pages that is not using a question mark: It uses "How To" instead of "How Do .... ?". Perhaps this could be an option?

Thanks for your answer. Unfortounately, the questions are fixed, so changing them to avoid this shortcoming is not an option.

Frankly, looking at the feature request, it is a little bit discouraging too see that small but reasonable feature requests like these are unresolved for more than four years, while new versions and new features are introduced at an ever faster pace.

I've opened a feature request for improving the way bug fixes are scheduled:

Anyone visiting this page, the link @Amalia Sanusi helpfully includes has had a name change. It's now called:

I don't see that - which version of confluence?

If you use certain characters in the title then you get the pageId, eg colon, semi-colon I think, otherwise you should get a sensible title.

Are you using any plugins? Eg scroll versions - not attempting to cast aspersions here, but I know that it supports multiple pages per space with the same title, so perhaps it gets round that using the pageId (alternately it may just put the version number in the url).

Hi Jamie. I am using Confluence 4.2.2.

I am using a pretty fresh installation and have only installed one or two plugins. However, there are a number of plugins listed of which I assume that they have been installed with the distribution (unless our admin has been active without telling me): Advanced Macros, Basic Macros, Code Macro Plugin, Confluence Attachments Plugin,Confluence HTML Macros, Dynamic Task List 2 Plugin, Google Maps Plugin, IM Presence NG Plugin, JIRA Macros, Support Tools Plugin, Tabular Metadata, Widget Connector

My problem really seems to come from the characters in the title. I am writing F.A.Q. pages, so essentially each title contains a question mark (and apostrophes are quite frequent). When I remove them, the pretty URLs appear. However removing the punctuation is not an option.

So my question would be: How to force pretty URLs in the presence of "evil" characters?

Ok, I just found this question which is at least in part a duplicate. It seems, thatz special characters (in my case a question mark) lead to the ugly URLS. However, the question remains, whether there is way to force Confluence to use pretty URLs and maybe replace any special character by somethin else?

Updated the title to reflect the question better.

Confluence should really support nicer URLs that can be remembered by humans (e.g. if someone enters a link in a presentation). Special characters forcing the ugly URL is a no go, using the noisy "+" instead of "-" as placeholder for spaces, as well as having 3 different ways to address a page (1. normal: display/KEY/PAGE 2. pages/viewpage.action?spaceKey=...title=... 3. pages/viewpage.action?pageId=). "display" and "pages"). It should encourage people creating a page to provide a simple URL name and not just take any arbitrary long title text. Github markdowns id generator for headings is a good way for automating that (but still users should be able to customize it). And then support URLs where the space is a subdomain and just the short name is used as path:



You can use scroll viewports which would enable you to manually decide if you want hierarchical or flat naming convention. It will also mean that you will never see a pesky "viewpage.action" link anymore.


We use Viewport for our customer facing Confluence space.

What's best about the Scroll Viewport add-on, is that you get to customise the them seperately to you confluence VM (Velocity macro template file).

This inlcudes a bunch of useful tools and utilities you can harness to do other work, for example, conditional page content, sometimes it's better to not render the HTML at all if the user cannot view it.

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 ...

791 views 33 5
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