How to use Redirection for Confluence
How to install Redirection for Confluence app
You first must have the app installed by a Confluence administrator. Ask your Confluence administrator to install Redirection for Confluence from the Atlassian Marketplace.
How to create or manage redirects in bulk across Confluence
Only Confluence administrators can bulk create and edit redirects.
Go to Confluence administration
Under Apps click on ‘Redirection’
Edit existing redirect or create new ones
How to create or manage a redirect on a single page
Open the app via More actions
On any page select ‘More actions’ to open the pull down menu. Then scroll down and select ‘Apps’ then 'Redirection’.
For existing redirects do not use the macro that was automatically inserted at the top of the page.
It is only possible to create or edit a redirection via More actions for single pages or under Confluence administration for bulk changes. Do not delete the macro at the top of the page, it needs to appear.
For a new redirect this will popup
Enable/disable redirect
The redirect is enabled by default.
Choose destination type
Choose where to redirect to
As you type pages will be suggested.
Decide if you want to remove the deny option
The default is disabled. If you move it to enable the option to deny the redirect and stay on the page will be removed.
Note: this makes it more difficult to get to edit mode.
Option to customize message
You have the option to customize the message that the user sees when he/she arrives on the page.
Note: you cannot use HTML in the text itself. You must use the WYSIWYG editor to create headings, bold, italics, underline, monospace, bullet points or numbering.
Preview
This is an exact preview. The above example uses the default message. If you customize the message it will show in the preview. If you disable the Deny option the button will be removed in the preview.
Save
Click save when you are happy with the preview.
How to add or edit a redirect on an archived page
To edit an existing redirect or to add a new redirect you first need to restore the page. It is not possible to make any edits to a Confluence page while it is archived.
Restore page (unarchive page)
There are two ways to restore an archived item back to the content tree:
directly from an archived item
from the archived pages list in the archive
Learn more: https://support.atlassian.com/confluence-cloud/docs/restore-archived-pages-to-the-page-tree/
Edit page
See above section How to create a new redirect or edit an existing redirect.
Archive page once again
When you have finished editing the redirect archive the page again.
How to temporarily disable an existing redirect
If you might use the redirect later rather than delete it the better option is to disable the redirect. The redirect will not show for any users, but all the setting including custom message will remain. Then all you would need to do is re-enable the redirect later.
After opening the redirect the first option to it enable or disable the redirect. Click to disable it.
How to delete an existing redirect
Open the redirect on a single page on in the bulk feature under Confluence administration.
Click ‘Delete redirect’.
This will permanently erase the redirect in Confluence including all custom messages created for it.
How to get to edit mode when deny button is disabled
There is no clear way to get to edit mode if the deny button has been disabled.
Here is the workaround:
Click anywhere on the page outside of the redirect popup. Then click the esc button on your keyboard.
Does not support pages using legacy editor
Saving a new redirect will automatically update the page to the new editor. Redirection by Easy Apps does not support the legacy editor.
Moving to the new editor could impact your page formatting, often related to third party macros. How to convert pages from the legacy editor to the new editor.
Can I remove the confirmation popup that must be clicked before a page visitor can be sent to an external URL?
Atlassian requires a warning message with a requirement to confirm before going to an external URL. A redirect to an external site cannot happen without a warning.