How to use Redirection for Confluence
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.
Bulk create and manage redirects across Confluence
Only Confluence administrators can bulk create and bulk edit redirects.
Go to Confluence administration
Under Apps click on ‘Redirection’
Edit existing redirects
Create new redirects one at a time
Create new redirects in bulk
Single page create and manage a redirect
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’.
A new redirect looks like this. Existing redirects show what was previously saved.
To edit existing redirects, open the redirect under More actions. Do not use the macro at the top of the page.
Confluence administrations can also bulk add or edit redirects under Administration.
Enable/disable redirect
The redirect is enabled by default.
Choose destination type
You first must choose the type of page you want to redirect to.
Then based on your response fill in the second field. Suggested search works if you are choosing a Confluence page within the same instance.
Option to remove deny
The default includes the popup message and the deny option.
Note: removing both the popup and deny makes it difficult to get to edit mode. See technical notes.
Custom message (optional)
If you do not want to use the default text that shows in preview then customize the message that users sees arrive on the page.
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.
Preview
The preview is what the user will see when they arrive on the page.
This example uses the default message, not the custom message. The blue hyperlinked text depends on what you selected under Redirect to. If you disable the Deny option the button will be removed in the preview.
Note: when you disable the popup the preview still shows, but the user will not see any popup.
Save
Save a draft/temporarily remove
To save a draft or to temporarily remove a redirect disable it.
Delete an existing redirect
A red ‘Delete redirect’ option will show when an existing redirect is opened. This includes when it is disabled.
This is permanent. All custom messages are lost.
Archived page
You must first restore an archived page before you can edit an existing redirect or add a new redirect. It is not possible to edit a Confluence page while it is archived.
Restore page (de-archive 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/
When you have finished editing the redirect you can re-archive the page.