Deprecation of Google Drive and One Drive macros
Platform Notice: Cloud Only - This article only applies to Atlassian apps on the cloud platform.
Summary
The Legacy Editor in Confluence Cloud is being deprecated
Starting January 2026, all new pages will be created in the cloud editor. To learn key details over the deprecation along with timelines, please visit this community post. By April 2026, all editing will take place in the Cloud Editor Differences using Confluence legacy editor and cloud editor.
In February 2022, the Google Drive and OneDrive macros were deprecated from the new editor to use Smart Links in Confluence Cloud.
Moving forward, on May 30, 2024, the OneDrive macro will also be deprecated from the legacy editor. The Google Drive macro sill still be available in the legacy editor.
Solution
FAQ
How can I embed Google Drive content into Confluence now?
In the new editor, from now on, simply pasting the link should convert it into a Smart Link, providing different options on how to have it displayed:

ℹ️ Using the Display embed option should be equivalent to how it was when using such macros. It also allows the content to be resized by dragging its borders instead of manually setting its size:

In the legacy editor, you can still use the Google Drive macro.
How can I embed OneDrive content into Confluence now?
In the new editor, from now on, simply pasting the link should convert it into a Smart Link, providing different options on how to have it displayed.
In the legacy editor, you’ll still be able to embed OneDrive documents into Confluence in two ways:
Convert legacy pages with the OneDrive macro to the new editor, where they’ll be automatically updated into Smart Links that provide the same functionality. Once the macro is deprecated, any existing instances of it that have already been inserted in the legacy editor will display a message suggesting that you convert to the new editor. We highly recommend previewing your page before converting.
Browse the marketplace for alternative vendor macro solutions.
How do I check the embedded document after switching to a Smart Link?
After you paste the document link in the cloud editor and select the Embed display option, check the result before you publish or update the page:
The correct document is displayed.
The embedded content is readable.
The embed size suits the page. To resize it, drag its borders.
If you're converting an existing page that uses the Google Drive or OneDrive macro, preview the page before you complete the conversion. Check that each embedded document and the content around it display as expected.
If an embedded document doesn't display as expected, your content hasn't been deleted. See Did any of my existing macros and data get deleted? below.
Did any of my existing macros and data get deleted?
No! All the existing content is in Confluence and no data loss happens with the deprecation. All the added content is still displayed as the "embed" option, exactly like it was before.
What if the embedded document doesn't load?
If you've already replaced the macro with a Smart Link embed and the document still doesn't load, you don't need to repeat the replacement. This is an embedding or browser problem, not a result of the macro deprecation.
Google documents: follow the browser troubleshooting steps in Unable to view Google Documents on Confluence pages | Confluence | Atlassian Support, such as opening the page in a private or incognito window or a different browser.
If the problem continues: contact your Confluence site admin. Share the page URL, the exact error message, and the results of your browser tests.
Related articles
Was this helpful?