Link Manager for Confluence

How to use Link Manager for Confluence

Across multiple spaces or on a single page.

  • bulk change Display URL to Display inline

  • bulk change Display inline to Display URL

  • bulk find and replace in URLs

Across multiple spaces

On the left side menu under ‘Apps’ select Link Manager. This is called a global page.

apps menu link manager.png

A single space

To use the app only on the current space you are on, while on a page on the bottom of the left side menu under ‘Space apps’ select Link Manager.

access link manager.png

Select spaces

When using the app as a global page you can select multiple spaces.

select spaces link manager.png

If you are using Link Manager under ‘Space apps’ you will not see ‘Select spaces’ as it restricts you to the space you are currently working in.

Select pages

  • user must have at least view permission to see a page as a search option

  • pages only appear under ‘child pages’ search if the parent page has children

All pages in space

The default page selection is all pages in all the spaces you have selected.

select pages.png

Child pages

When you select a parent page under ‘Child pages’ by default it only includes the child pages. In order to include the parent pages you must check the box ‘Include selected parent pages’.

child pages.png

Pages I select

Choose pages one by one, as many as you want.

pages I select.png

Search by page titles

Enter a term to get a result of all the page titles that contain the term.

search by page titles.png

Preview

The preview is a required step before you can submit changes.

preview.png

In preview: select all or unselect all pages

  • if you ‘Unselect all’ and then ‘Select all’ it will include all the links, including any links you previously unselected individually

In preview: expand or collapse

Across all pages

  • ‘Collapse all’ is the default state, use it to only see the page titles

  • use 'Expand all' to see all links on all pages

Per page

  • click ‘Select / unselect all’ to include or exclude all the links on a page from changes

Individual link

  • deselect links you do not want to change

Even if a link is selected nothing will change unless you actively make a change (link text or change how it displays). Meaning you are not required to deselect links that are not changing.

In preview: edit base URL and display text

Changing the underlying URL and text of a link are done separately.

preview URLs.png

Select edit icon to make a change.

preview edit URL text.png

In preview: change from Display URL to Display inline (or the reverse)

In this example URL is the what the link currently is.

Display URL.png

It is being changed to ‘Display inline'. The preview disappear because Line does the base URL.

Display inline.png

‘Display URL’ (URL) means it shows the full URL. You can customize the text that is displayed.

Example: if the underlying Display URL is by default displayed as https://www.atlassian.com/ you could edit it to Atlassian homepage.

Display inline’ (Inline) means it shows the meta title of the link. This is done automatically when you paste a link into Confluence. Example:

Atlassian links use a system they call smartlinks. Learn more.

Confirm changes

After all edits have been made click the ‘Submit’ button in the bottom right.

submit button.png

Confirmation

The check mark icon shows next to URLs that have been updated. Those with no status icon have not changed.

confirmation.png

Bulk replace URLs (space admins only)

Space administrators can also bulk change the underlying URLs.

Global page access

When using Link Manager under ‘Apps’ select the tab 'Space admin features' select the spaces where you want to find the links.

space admin URLs.png

Space Apps access

If you are using the app under ‘Space apps’ you need to click the ‘More actions’ button at the bottom. It will take you to space settings. Only administrators see this button.

more actions.png

Bulk change URLs

Enter both the terms to ‘Find in URLs’ and to ‘Replace with’. If replace is left blank the find term will be removed from the URL.

Click 'Find' to preview changes.

You have the option to edit the display text per URL.

space admin URL change.png

When you are happy with what you see in the preview click ‘Replace’.

replace.png

The check mark icon under status means it has successfully updated.

replace URL confirmation.png

Why does it still say ‘LinkedIn’ and not reddit? The underlying URL was changed. The display text is edited separately per link.

While working on a page select ‘More actions’ (…) in the top right to open a pull down menu. Then scroll down to ‘Apps’ and choose 'Link Manager’.

page level access link manager.png
page level link manager.png

Editing links on the page level is almost identical to doing so at the space level. See above for editing details.

Note: only administrators can see the ‘App settings’ and ‘More actions’ buttons