Convert Absolute Links to Confluence Links
Prior to upgrading to recent versions of Confluence, you could have created links to pages in Confluence by copying and pasting the URL from the browser address bar. Even though the link works, there are some problems with that method, including:
Loss of some features (incoming links, for example)
Broken links if you change the title of a page
Loss of functionality (changing the base URL, exporting the space to another instance without breaking links)
To avoid these problems, use Convert Absolute Links to Confluence Links to convert links to the correct internal storage format. If any page has links that are required to be updated, a new page version is created, allowing you to roll back if necessary.
Convert Absolute Links to Confluence Links handles links with anchors, but anchors are still difficult to use in Confluence because they contain the page name. If a link with an anchor does not work correctly before running this built-in script, the script will not fix it.
Your base URL must be set correctly for this to work, and the base URL must match the full URLs in the pages. If it does not, the links do not appear as candidates for rewriting.
If an absolute link points to any version of the page other than the current version, it won’t be converted to a Confluence link.
Run this script
Follow these steps to run the built-in script:
- Navigate to General Configuration > ScriptRunner > Built-In Scripts.
- Select Convert Absolute Links to Confluence Links.
Choose one of the following:
Select the All Spaces checkbox if you want to run the script on all global spaces.
Enter the specific space you want to work with for Space.
You can select Preview instead of Run to view results before running the script.
Once you select Run, the Results of the script appear.