Confluence Mapping

Find any old DC URL, PageID, or page title in your migrated workspace — instantly.

Admin panel — upload and manage your migration CSV

What it does

When you migrate from Confluence Data Centre to Cloud, every old URL embedded in documents, tickets, emails, and bookmarks stops working. Confluence Mapping solves this in three steps: an admin uploads the migration export CSV, the file is indexed automatically, and any user can then search for an old URL, PageID, or partial page title and get the live Cloud equivalent in under a second.

Key capabilities

• CSV upload — admin uploads migration export from settings panel
• Automatic indexing — no manual configuration, no waiting
• Multi-format search — by old URL, PageID, or partial page title
• Bulk search mode — multiple queries at once
• CSV export — download results for auditing
• Real-time analytics — every search logged to dashboard

SQL Queries for DC Links

Extract old Data Centre page IDs and URLs directly from your Confluence DC database to build the mapping CSV.

Why you need this

To build a complete mapping file, you need a list of every old DC page ID and URL from your Confluence Data Centre instance. The standard Confluence migration export does not always include this for every page — running a SQL query against your DC database is the most reliable way to get a complete list.

PostgreSQL

SELECT 
  c.CONTENTID AS dc_page_id, 
  s.SPACEKEY AS space_key, 
  c.TITLE AS page_title,
  CONCAT('/wiki/spaces/', s.SPACEKEY, '/pages/', c.CONTENTID) AS dc_link
FROM CONTENT c 
JOIN SPACES s ON c.SPACEID = s.SPACEID
WHERE c.CONTENTTYPE = 'PAGE' 
  AND c.CONTENT_STATUS = 'current'
ORDER BY s.SPACEKEY, c.TITLE;

MySQL / MariaDB

SELECT 
  c.CONTENTID AS dc_page_id, 
  s.SPACEKEY AS space_key, 
  c.TITLE AS page_title,
  CONCAT('/wiki/spaces/', s.SPACEKEY, '/pages/', c.CONTENTID) AS dc_link
FROM CONTENT c 
INNER JOIN SPACES s ON c.SPACEID = s.SPACEID
WHERE c.CONTENTTYPE = 'PAGE' 
  AND c.CONTENT_STATUS = 'current'
ORDER BY s.SPACEKEY, c.TITLE;

Expected output

Export the query results as CSV. You will combine this with the Cloud mapping data from Atlassian (see next page) before uploading to Link-a-Link.

Cloud Links from Atlassian

How to request the DC-to-Cloud page ID mapping file from Atlassian Support after your migration.

What this is

When you migrate from Confluence Data Centre to Cloud, Atlassian generates a mapping file that links every old DC page ID to its new Cloud equivalent. This file is not always provided automatically — you typically need to request it from Atlassian Support after the migration completes.

How to request

1. Go to Atlassian Support (support.atlassian.com)
2. Create a new support request under Cloud Migration
3. Request the DC-to-Cloud page ID mapping file for your migration
4. Specify your migration batch date and Cloud instance URL
5. Atlassian Support will provide a CSV file mapping old DC page IDs to new Cloud page IDs

Expected file format

The mapping file from Atlassian will look similar to this:

Combining with your DC export

Once you have both files (your DC export from the SQL queries and the Cloud mapping from Atlassian), combine them into a single CSV with columns for the old DC URL/page ID and the corresponding new Cloud URL. This is the file you upload to Link-a-Link.

Uploading the migration CSV

Admin guide for uploading your Confluence Cloud migration export.

CSV upload interface in the admin panel

Steps

1. Open Link-a-Link admin → Confluence Mapping
2. Click "Choose .csv file..."
3. Select the migration export CSV from the Confluence Cloud migration assistant
4. Click "Upload CSV"
5. The file is processed and indexed automatically

Supported format

The standard export format from the Confluence Cloud migration assistant is supported. At minimum, the CSV needs columns for the old URL (or PageID) and the new Cloud URL. The admin panel validates the file on upload and shows a clear error if the format doesn't match.

Searching for old links

How users search for old DC URLs, PageIDs, and page titles.

Link Lookup — the global search interface

How to search

1. Open the Link-a-Link global app page in Confluence
2. Type your query into the search box
3. Results appear instantly as you type
4. Click any result to open the live Cloud page

What you can search by

• Old DC URL — paste the full old URL
• PageID — just the numeric page ID
• Page title — partial title matches work too

Bulk search & CSV export

Look up multiple old links at once and export results.

Bulk search

The bulk search mode accepts multiple queries at once. Useful when you have a list of old links that need to be resolved as part of an audit or remediation project.

1. Open the Link-a-Link global page
2. Switch to Bulk Check mode
3. Paste your list of old URLs, PageIDs, or titles (one per line)
4. Click Search
5. Review the results table

CSV export

Export the results table as CSV for reporting, auditing, or sharing with your team. The export includes the original query, the resolved Cloud URL, and the match status (found / not found).