It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

How to handle Unique page names in confluence?

Fabian Lopez Aug 28, 2011

I have one space with the documentation of our products. We have in the same space (for specific version) the User Manual, Admin Manual, config manual, etc.

Each of them have a page/section called "Introduction", "Overview" "How to..." etc.

I understand that we can have "unique" pages names on confluence in the same space and that the "tinyurl" is unique. My question is why Confluence is using the "pagename" (that could be edited anytime") as index instead of the tinyurl?

What is the workaround recommended to handle pages with the same name on the same spaces as it was described below?

3 answers

1 accepted

0 votes
Answer accepted
Kevin Buchs Aug 28, 2011

Another work-around is to put all the content into one page. This probably becomes a pain to edit, but you could present an efficient interface to the user by using {toc} and/or {cloak}/{toggle-cloak}.

You might also {include} the contents of other pages for the subsections which have prefixed names but then the user will only see the headings on the main page, which don't need to include a prefix.

Oh, another thing, Confluence itself maintains many-many spaces on its documentation [wiki instance|]. You can use Space groups for organization (e.g. for each product).

Oh, and another thing, with regard to my original answer, you can generate a table of contents by hand, which can contain labels that lack the prefix while still linking to a page with the prefix, e.g. \[Introduction|UM_Introduction]

Fabian Lopez Aug 28, 2011

I will review which method to use. I need to consider the potential need of exporting the content to word or pdf with Scroll Office.

thanks for your input

0 votes
Kevin Buchs Aug 28, 2011

Confluence is using the tiny URL behind the scenes, but the page name association is used so that you can change the page name whenever you want.

I suppose the solutions are obvious:

1. Create a prefix or suffix which you use on all page names of a group, e.g. UM_, AM_, CM_.

2. Create a separate space for each of your manuals.

Fabian Lopez Aug 28, 2011

Thanks Kevin. I thought about that, but I am really questioning why if Confluence has the tinyurl as unique identifiers Atlassian is using the page name as index (which is not unique and it can be changed anytime per the user). Iwas hopping to have a better fix on this in the upcoming confluence 4.0 release.

The acronymn is a good workaround. The spaces in our case is not a good idea due that we have more than 30 products with multiple versions released every year. We will prefer to keep one space per product per release to contain all the documentation. I think acronym could be a better approach in this case.

Fabian Lopez Aug 28, 2011

Actually it is a workaround but not the best one, due that you will see on the table of content the UM_Overview instead of just the plain Overview.

but it will work for now

Kevin Buchs Aug 28, 2011

Fabian: Confluence does reference the human-readable page name for that is easier to remember and reference. It sort of fits the Wiki ideal of hyperlinking as much as possible whenever you make a reference to it. If we had to look up the tinyurl every time we wanted to insert a link, it would get old quickly.

0 votes
Markus Majer Apr 24, 2018

Just use an tag in front of your site, like [CLIENTNAME] Introduction - this makes the pagename unique and also helps you finding the page with the search ajax field - if your search results are ten times entries Introduction, it makes no sense.

Suggest an answer

Log in or Sign up to answer
This widget could not be displayed.
This widget could not be displayed.
Community showcase
Published in Confluence

6 Awesome Ways to Apply Trello, JIRA and Confluence to your Project

I attended  Atlassian Summit 2019  and learned a lot from the presenters, attendees and knowledgeable Atlassian product managers. The presentations I attended focused on applying Agile, pla...

1,542 views 8 19
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