Is there a way to update links easily? Edited


We have a product space that links to other product spaces. For each new release, the links must be updated to point to a new version. For example:

There are 1200 links in one space pointing to this space:

When a new version is released, we need to update those links to:



I am not referring to intra-space links, as they update automatically when we copy a space, I have a problem with inter-space links.

I want a solution that does not require access on server side or in the database.

I know we can use excerpts or includes.

Does anyone know if the Easy Space Variables plugin would work for this?

2 answers

One option would be to do a search and replace on the links. Here is a user macro for space-wide search and replace on the Confluence Storage Format:

so you could search for https://company/display/SPACE88/ and replace with https://company/display/SPACE89/, but make sure you preview the changes first to make sure that you're not changing anything accidentally that you don't want to.

Ted Costales Atlassian Team Aug 30, 2017

This is a good answer if you're looking to make your changes with a minimum amount of additional plugin management, @Sanet Minnie. Let us know if this works out for you! If you'd rather a more in-depth answer with some addons available from the Atlassian Marketplace, the this answer provided may help as well.

The commercial projectdoc Toolbox can do this with the free Information Systems Extension, specifically the System Link Macro.

Links to external servers will use a space property at render time. Therefore all links to this external systems can be changed by changing the value of this one property. With the autoconvert feature, links that point to a configured external resource will automatically be converted to the macro (making it easier to add new links).

EDIT: The autoconvert of a link to the macro that checks for the space property will (currently) only work if the page can be accessed with anonymous privileges (see below). Otherwise you would need to set the label in the macro manually which I would assume to be too cumbersome to do. My solution also does not solve the problem of the current links to be converted to the 'macro form' (so you would also need a one-time replacement process like Stephen mentioned in his answer). 

There are also more features like transclusion or links to certain servers (see Domain References). The current version does not allow to link to a restricted resource and automatically authenticate.

Here is more information related to this topic:

Please note that I am one of the authors of the projectdoc Toolbox and the extensions. So my answer may be biased ...

You can check if these add-ons meet your use cases: The projectdoc Toolbox is available on the Atlassian Marketplace for Confluence Server. The Information Systems Extension (also available on the Atlassian Marketplace) is available for free, but needs services from the commercial projectdoc Toolbox.

Ted Costales Atlassian Team Aug 30, 2017

This is a good answer too that has some more expanded information and strategies for if you're attempting a larger scale migration of links and information! Big ups for the information.

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Dec 18, 2018 in Confluence Cloud

Happy holidays from our team to yours!

Hi Community!  2018 was filled with changes for our team, both big and small, and we've taken a lot of time to both celebrate our wins and recognize areas of improvement. One thing that we're a...

458 views 3 18
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