Handling duplicate space keys during Confluence space migration without affecting content

Question

We are migrating spaces between two Confluence Data Center instances (source and target). During the migration process, we encountered an issue where some spaces in the target instance already have the same space keys as spaces being migrated from the source instance.

Problem:

When migrating spaces with duplicate space keys, we are getting an error that the space key already exists in the target instance, even though the spaces are different. We need a solution to avoid this conflict without altering the actual content of the spaces.

Question:

Is there a way to rename the space keys of the spaces being migrated (or already existing in the target) without disrupting the content or functionality of the spaces? This would allow us to avoid the duplicate key conflict and complete the migration smoothly.

Environment:

• Confluence version: 8.5.15

• Deployment: Data Center

Looking forward to your guidance on how to handle duplicate space keys effectively.

Khammampati Surendra · Answer

Thank you @Sagar Mahajan @Rilwan Ahmed

Rilwan Ahmed · Answer

Hi @Khammampati Surendra ,

Confluence does not allow to import spaces with existing spacekeys. If the solution mentioned by @Sagar Mahajan is complicated, then try this workaround.

1. In source confluence (if its above version 8.3), copy the space and give new spackey which does not exists in target confluence
Please note what all will be copied or what will not be as mentioned in https://confluence.atlassian.com/conf85/copy-a-space-1283359602.html

2. Export the copied space and import  to target confluence.

3. If you need source and target spaces under one space, then move all pages of imported space into existing space.

Sagar Mahajan_d8sqh7 · Answer

Hi @Khammampati Surendra You can follow the Solution-3 for updating the the space key in XML file after you export the space from source instance and update the same begore importing to the target instance

https://confluence.atlassian.com/confkb/how-to-copy-or-rename-a-space-in-confluence-169578.html#HowtocopyorrenameaspaceinConfluence-solution3