Description

Before migrating Excel for Confluence macro content from server/DC to cloud, we recommend reading this Atlassian article to plan your migration.

Administrators must ensure that the following feature flag is enabled in the server/DC instance as a part of the pre-migration setup:

migration-assistant.app-migration.feature: <Confluence_URL>/admin/darkfeatures.action

Refer to the Getting started page from Atlassian for more information about the prerequisites for the migration.

This page explains:

Migration process
Differences between the server/DC and cloud version of the app

Migration process

Confluence instance migration - Use the Confluence Cloud Migration Assistant app to migrate everything you need from Confluence server/DC to Atlassian cloud. Confluence Cloud Migration Assistant explains in detail the step-by-step procedure to migrate the required content. As mentioned in the previous section, Atlassian does this job for you in most cases.
App installation - Install the app from Marketplace.

On completion of migration from version 7.0.0:

All global configuration data in the Configuration page are transferred from the server instance to the cloud instance.
If multiple migrations are performed on the same cloud instance, the latest migration takes precedence.
Any subsequent migrations performed on the same cloud instance only adds or merges the data, but does not delete any existing data.
Migration of Profiles using CCMA is supported from Excel for Confluence, server version 7.3.1.

Important information:

The migration of data from server to cloud is an independent process from app installation or configuration in your cloud instance. We recommend that administrators verify that all your data (configuration as well as your Confluence pages) are displayed properly after the migration process is completed. Please report any issues immediately.
We capture certain details, excluding private user data or any personally identifiable information, during the migration process to help us improve our app continually. Refer to Analytics data to know more about the what information is collected.

Differences between server/DC and cloud versions

The Excel macro features available in the server/DC versions are mostly supported in the cloud version as well. The following table lists the macro's parameters and features that work differently in server/DC and cloud:

Parameter/Feature	Server/DC	Cloud	Notes
URL whitelisting	Supported natively by Confluence	Administrators must manually whitelist the URLs in the Global Configuration page, because Confluence Cloud does not natively support URL whitelisting.	For more information, refer to CLOUD-2636.
Blacklist domains	Supported	Not supported	Due to certain technical restrictions, the feature is not available with the app's cloud version.
Profiles	Not supported	Supported	Administrators configure some parameters, such as the base URL of the location, user name and password and so on, required to access Excel files from external locations. Users can provide the relative path that points to the actual location of the files through a relevant profile. To know more about profiles, read the documentation.
Stop encoding of HTML characters	Supported	Not supported	Due to certain technical restrictions, the feature is not available with the app's cloud version. Refer to XL-361 - Getting issue details... STATUS for more updates.
File encoding	Supported	Not supported	Due to certain technical restrictions, the feature is not available with the app's cloud version. For more updates, refer to XL-387 - Getting issue details... STATUS .
Name of attachment in the path	Supported	Not supported	Confluence cloud does not support access of files from disk or folder.
Default process with Legacy and Current options	Supported	Not available	The app implicitly takes care of this process and thus, does not provide this parameter in the Cloud app.
Use column information from excel sheet check box	Supported	Not supported	Confluence cloud does not support this parameter.
Language for number and date formats Country for number and date formats	Supported	Not supported	Due to certain technical restrictions, these parameters are not available with the app's cloud version. For updates on the Language parameter, refer to XL-386 - Getting issue details... STATUS . For updates on the Country parameter, refer to XL-385 - Getting issue details... STATUS .
Table Filter, Pivot Table, and Chart from Table macros	Supported	Not supported	Confluence cloud does not support use of inline macros.
Ignoring trailing blank rows and columns	Supported	Not supported	Due to certain technical restrictions, the feature is not available with the app's cloud version.
Table class and table width	Supported	Not supported	Confluence cloud does not support these parameters. Refer to XL-383 - Getting issue details... STATUS and XL-382 - Getting issue details... STATUS for more updates.

Please note that all the other parameters function the same in both versions of the app.

Problem reporting

If you experience any problems or behavior changes that are unexpected, refer to Help and open a ticket with us. This helps us identify and prioritize fixes and improvements.

Browser not supported