Migrating from Confluence Data Center to Confluence Cloud
Migration from Confluence Data Center to Confluence Cloud is supported to some extend.
You will find in this page an overview of what features are supported as well as a migration guides. Contact us when you have a scenario that is not directly supported.
Include App edition
Supports Bitbucket Cloud
Confluence Data Center and Server
(except Ant patterns)
(only Bitbucket files)
The Data Center and Cloud Edition have different feature sets:
Confluence Data Center
Automatic Migration Supported
Bitbucket files by Ant Patterns
(only Bitbucket Data Center)
Bitbucket open pull requests
Bitbucket Git branches
Bitbucket Git commits
Bitbucket Cloud issues
Migration from Confluence Data Center to Cloud
1. Prepare Bitbucket instance
The Include Bitbucket for Confluence app supports both, Bitbucket Data Center and Cloud. You can choose to migrate to Bitbucket Cloud when migrating to Confluence Cloud as well, or keep the existing Bitbucket Data Center instance.
In case you keep your repositories on Bitbucket Data Center: it needs to be accessible via HTTPS on the public internet.
2. Configure Access to Bitbucket in Confluence Cloud
Configure access to Bitbucket in Confluence Cloud:
Configure Access to Bitbucket Cloud
Configure Access to Bitbucket Data Center
3. Migrate using the Confluence Cloud Migration Assistant
Use the Atlassian Cloud Migration Assistant to migrate the Confluence spaces.
4. Bitbucket Application Link replacement after migrating
After migrating from Confluence Data Center to Cloud, you must provide a fallback for the application link to Bitbucket for migrated macros.
Selecting the Bitbucket Edition:
If the referenced repositories are still on your Bitbucket Data Center instance, then select Bitbucket Data Center and provide the public URL to it. You must configure the Data Center settings as well.
If the repositories are now on Bitbucket Cloud, select this option and configure the corresponding Bitbucket Cloud workspace.
The repository must be named the same as before the migration.
Following limitations apply for migrating from Confluence Data Center to Cloud:
Only Bitbucket file macros are migrated automatically. All other macros (like e.g. the pull request or branches macro) have to be recreated.
The Bitbucket file macros are migrated in read-only mode. When you want to edit the macro parameters, you have to recreate the macro.
If the Confluence Cloud instance is connected to multiple Bitbucket instances, then the macro can’t determine the right Bitbucket instance. It will show manual migration steps in that case.
File ranges, regexes and hiding file headers is not supported.