Redirection
Breadcrumbs

Technical notes Redirection for Confluence

Never delete macro at top of the page

macro redirect.png

A macro appears at the top of all pages that have added a redirect.

  • Never delete this macro

The app must insert this macro, if not the redirect will not work. Why? Confluence does not allow for a more traditional 301 Moved Permanently.

Not supported

Legacy editor

Redirection does not support the legacy editor.

Converts legacy editor page to new editor

Saving a redirect on a page using the legacy editor will automatically update the page to the new editor.

Moving to the new editor could impact your page formatting, especially if you are using older third party macros. See Atlassian post Convert pages to the cloud editor.

HTML

HTML is not allowed in the custom message fields. The WYSIWYG editor is the only option. It allows to create headings, bold, italics, underline, monospace, bullet points or numbering.

Enable/disable popup

Redirecting within same Confluence instance

A popup to confirm within the same Confluence instance is optional.

If the popup is disabled, after the page fully loads the user will be taken to the Confluence page it is set to forward to.

This makes it difficult to get to edit mode for the page that has a redirect placed on it. See note Getting to edit model when deny disabled.

Confirm before going to external URL

A popup to confirm before going to an external URL is required.

Atlassian requires the popup with a warning message and a confirmation button in order to proceed to all external URLs. A redirect to an external site cannot happen without this popup.

Atlassian does this for security reasons. Many users and developers are complaining that this is too restrictive. In the future Atlassian might create a list of URLs that do not require a confirmation or do away with the requirement entirely. But no timeline has been given.

Getting to edit mode when deny disabled

There is no direct way to get to edit mode on the page with a redirect if you remove the button to deny the redirect. This is also the case when the entire popup is disabled.

Workaround

Be quick. It must be done before the redirect page macro loads. Click anywhere on the page outside of the redirect popup (if has one). Then click the esc button on your keyboard. No harm clicking it multiple times.

If it doesn’t work reload the page and try again.