It is possible to have native HTTP redirects for pages moved or renames in Confluence?

It is possible to have native HTTP redirects for pages moved or renames in Confluence?


One condition: this has to work by default, without having to ask the user to do somethign else after he moves or renames the page.

I was amazes to discored that this basic functionality was not a core feature by design.

1 answer

1 accepted

2 votes
Answer accepted

According to the docs, all links should update automatically when you move or rename a page. You just have to make sure your links are not web-links that start with http...use Confluence page links instead.

I will test this myself. Still I do think that confluence should be smart enough to fix even web-links. We cannot assume that everyone will insert only internal links when writing wiki pages. I would not even consider this as an enhancement, just a bug.

Sorin, I disagree with you... There should be no expectation that Confluence will keep external links updated.

I would be interested to find out why you disagree.

Maybe we're not thinking of the same thing.

I'm thinking if you have, say, a link on a Confluence page to, say, a page on (let's use if that Stackoverflow page's link changes, then Confluence would have no way of knowing where the new URL is, unless the owners of Stackoverflow provided a redirect URL or some other info in the response to indicate the new location.

Shortly, Confluence should be able to detect 301 and 308 HTTP responses and correct the links inside the pages. Also, Confluence shold return 301 HTTP responses for pages that were moved or renamed. These are two different features but that by combining do solve the missing page problem in the correct way (the web way). The current behavioud of responding with 200 response and a page that is telling you that the content was moved is silly and denotes a clear lack of knowledge on how an web application is supposed to be implemented.

Ironically, clicking that very link posted earlier ( now renders as a 404 because someone moved the page:


  • Expecting Confluence to keep external/outbound links up-to date (via polling, prefetching, whatever) is achieveable. HTTP 301 requires the new URI for the resource in the response, so if the external resource is well-behaved then Confluence should be able to work with it. Personally I agree with Sorin, but I can also understand why some folks would make the argument that external URIs are out of scope.
  • Expecting Confluence to keep internal/inbound links up-to-date should be a given, and IMHO it is embarrassing that this is not the case. Even MediaWiki managed to make this work years ago. It shouldn't matter whether the link was created from raw html, or Confluence markup, or whatever. If it is rendered to the end-user as a link, it is a link. Confluence should be able to detect and maintain incoming links regardless of whatever format was used to input them. If it is a link within the same Confluence instance, there is no excuse for not redirecting properly.

Documentation in most organisations will exist in a continuous state of flux, and probably as a heterogeneous combination of emails / multiple wikis / documents on fileshares / links embedded in source code/comments / etc. etc... most of which will likely have static links, and these will grow increasingly stale as time passes. Having them return 404 for a moved Confluence resource harms the user-experience, and therefore (likely) also the adoption of Confluence. It's also contrary to RFC7231:

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Mar 12, 2019 in Confluence

Confluence Admin Certification now $150 for Community Members

More and more people are building their careers with Atlassian, and we want you to be at the front of this wave! Important Dates Start the Certification Prep Course by 2 April 2019 Take your e...

1,031 views 2 13
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