Migrating SharePoint Connector for Confluence Data Center to Cloud

Atlassian is ending support for Confluence Data Center by March 2029.
This page explains how SharePoint Connector for Confluence will be migrated from Data Center to Confluence Cloud, what you need to prepare, and what you can expect.

🔎 Quick overview

Question	Answer for SharePoint Connector for Confluence
Migration effort and automation level	Medium – Usually one migration run with some manual configuration steps. Partially automated – Core page links and attachments are migrated automatically; some settings (e.g., space permissions or macros) require manual review.
Main risks/limitations	Authentication methods differ; OAuth setup may be required.
Key prerequisites	Active SharePoint Online environment Confluence Cloud site provisioned and accessible Backup of Confluence Data Center spaces recommended Test migration in a staging environment suggested
Best practice	User impact during migration: Short downtime recommended; read-only mode advised for affected spaces. Typical duration: From several minutes up to a few hours, depending on the number of linked spaces and pages. Recommendation: Perform migration outside business hours or on weekends.
Available Cloud types	SharePoint Connector for Confluence is available on Commercial Cloud.

What SharePoint Connector for Confluence does

SharePoint Connector for Confluence allows your teams to connect Confluence pages with documents, folders and lists stored in Microsoft SharePoint Online and Microsoft OneDrive.

It enables linking, browsing, and managing SharePoint documents, folders and lists directly from Confluence pages, keeping documentation centralized and accessible without leaving Confluence.

🔄 How to migrate

Please unfold the sections below to view the complete, detailed instructions for the upcoming migration.

By expanding these folders, you will gain access to all the necessary steps and guidelines for a smooth, successful migration.

Before you start

Install and Configure in Cloud
- SharePoint Connector for Confluence must be installed on your Confluence Cloud site.
- App settings are not migrated; configure them separately.
Environment Preparation
- Ensure an active SharePoint Online environment.
- Provision and access your Confluence Cloud site.
- Recommended: Backup your Confluence Data Center spaces.
Permissions & Access
- Confirm you (or a service user) have edit permissions on all pages with SharePoint Connector macros.
- Prepare Atlassian Confluence API token for cleanup tasks (post-migration).
Test Environment (Recommended)
- Consider a staging environment for trial migration to detect issues early.
Communication
- Notify users about potential downtime or read-only mode during migration.

How the migration works

Prepare Your Environment
- Ensure SharePoint Online is active and accessible.
- Provision and access your Confluence Cloud site.
- Backup Confluence Data Center spaces.
- Install the latest SharePoint Connector for Confluence in Data Center.
Test Migration (Recommended)
- Conduct a trial migration in a staging environment to identify any potential issues.
Run the Migration
- Use the Confluence Cloud Migration Assistant.
- Select SharePoint Connector for Confluence during the migration.
Validate Post-Migration
- Check linked SharePoint documents, folders, and lists.
- Verify space permissions and page restrictions.
- Re-authorize Microsoft 365 connections if needed.

After Migration

Finalize Configuration
- Confirm all SharePoint links and macro settings are functioning.
User Communication
- Notify users that the system is fully operational.
- Consider scheduling migrations outside business hours to minimize disruption.
Decommission Data Center Instance
- Only after validation and successful migration.

🤝 Support & resources

Documentation for SharePoint Connector for Confluence
- Link to official docs
Marketplace listing
- Link to app on Atlassian Marketplace
Cloud Security Standards
- Link to Communardo Cloud Security Standards page
Feature parity & known limitations
- Link to parity/limitations page
Need help with planning or running your migration?
- Link to Communardo support

❓ FAQ for SharePoint Connector for Confluence migration

Can users work while the migration is running?
Read-only mode for affected spaces is recommended to avoid inconsistencies.

What is not migrated automatically?

The SharePoint Connector for Confluence macros and their macro configurations are migrated automatically. However, the following items require attention after the migration:
- Block macro formatting: Block macros can be converted to inline macros. This can affect the layout of pages.
- SharePoint List column configurations: The old Data Center version uses the predefined “View” properties of a SharePoint list. This functionality is not available in Cloud, which uses the column configurator instead. Therefore, users need to update their column configurations after migration.

What are the biggest changes compared to Data Center?

Infrastructure fully managed in Cloud
Some macros or integrations may behave differently in Cloud

Are you a solution partner and have questions about licensing during migration?