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

Can I reuse text (product name) in the title of pages?

Eva Mayrhofer Oct 06, 2014


I am using Confluence to write technical documentation for our products. When I need to write the product name in the body of the pages, I am using the macro "Include+" of Scroll Versions (a plugin for Confluence). When the product name changes (this happens sometimes), I just change the product name once and all usages are updated.

However, it is not possible to use macros for the title of pages. The manufacturer k15t of Scroll Versions has confirmed that this is an Atlassian restriction as it is a plain text field.

So I have to either use a general expression (instead of the product name) in the page titles or I have to update all page titles where I have written the actual product name.

The second possibility (to write the actual product name) would be fine as long as it is possible to quickly replace certain expressions (such as a product name) in Confluence articles.

Does somebody have any ideas?

Cheers, Eva

4 answers

1 accepted

0 votes
Answer accepted
Tiago Comasseto Oct 07, 2014

Hi Eva, this is not a very elegant alternative and a bit dangerous if not using carefully, but you could update the title of multiple pages at once directly via database.

You can use the following query as an example:

   SET TITLE = REPLACE(TITLE,'<old_title>','<new_title>');
  • <old_title>: string to search on the field TITLE, which will be replaced for '<new_title>';
  • <new_title>: string which will replace '<old_title>';

It would also require Confluence restart and possibly re-index.


Eva Mayrhofer Oct 08, 2014

Hi Tiago, thanks for you tip. I will keep it in mind. Just a short question: Is it necessary to have the full title in the query? Or is it possible to use wildcards? For instance, {{SET TITLE = REPLACE(TITLE,'*xyz*',*abc*');}} would replace the expression "xyz" in all page titles that contains "xyz". Cheers, Eva

Tiago Comasseto Oct 08, 2014

Hi Eva, you can use just part of the title. For example, if you have two pages, one with title A123 and another with title B123, the following update with change both to A321 and B321 respectively.

   SET TITLE = REPLACE(TITLE,'123','321');


Eva Mayrhofer Oct 08, 2014

Thanks, that's good to hear.

0 votes

Hallo Eva, I found it interesting that you're using the include+ macro to manage the product names in your documentation. We've also Scroll Versions installed but for a similar use case I'm using the Multi-Excerpt-Plugin. Did you create one page for every product to contain the name and then include this page with include+ to all pages the product name is used on? You can answer me via pm if you like (kgebert at e2e dot ch). Cheers, Kirstin

0 votes
Eva Mayrhofer Oct 20, 2014

Hi Kirstin, let me detail how I am using the include+ macro regarding the product name: We have just one product (= the main product). So I have just one page with the product name. Let's call this page: PROD But we have different variants of the product. So I have one page for each variant as well. Let's call these pages: VAR1 and VAR2 (for 2 variants) The pages VAR1 and VAR2 are using the include+ macro and it links to page PROD. The name of the respective variant is written after the include+ macro. The descriptions valid for variant 1 are using the include+ macro and it links to page VAR1. So the description mentions the product name and the name of the variant 1. The descriptions valid for variant 2 are using the include+ macro and it links to page VAR2. So the description mentions the product name and the name of the variant 2. When the product name changed (the name of the variants remained the same), I just had to change the content of the page PROD. All descriptions that mentioned the product name (because of the include+ macro) were updated as expected. I did not have to change the content of VAR1 and VAR2. Also: I am having an internal space that contains all sources of the descriptions. When a new version of the product is released, I publish the description to a new space that can be accessed by anyone (I am using Scroll Versions for this publish process). It is possible to change the product name in the published space at any time as well. This is rather handy for us. I hope this explanation helps. If not, let me know. Cheers, Eva

0 votes

Thanks, Eva, for your detailed explanations. It would be interesting to meet other users on a sort of technical documentation/Scroll Versions gathering. :) LG Kirstin

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

2,400 views 11 28
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