How to embed Google Drive videos on Confluence Cloud
Platform Notice: Cloud Only - This article only applies to Atlassian apps on the cloud platform.
Summary
This article explains how to embed a Google Drive video on a Confluence Cloud page.
Environment
Confluence Cloud
Solution
Current method — use Smart Links (Cloud editor):
Open or create a page in Confluence (all pages now use the Cloud editor).
Paste the Google Drive video URL directly into the page.
The link automatically converts to a Smart Link. Select the link, then choose Display as embed from the floating toolbar.
The video will play inline on the page, equivalent to the old macro behavior.
For full details, see Deprecation of Google Drive and One Drive macros | Confluence | Atlassian Support.
Verify the embed works
After selecting "Display as embed":
Click Publish (or exit edit mode) and confirm the video player appears inline on the published page — you should see a playable video frame, not just a link or card.
Click play to confirm the video streams directly on the page.
If it only shows a card or inline link (not an embedded player):
Confirm the Google Drive video's sharing settings allow at least "Anyone with the link can view" — private videos cannot render as embeds.
Try selecting the Smart Link again and explicitly choosing Embed from the display options (URL → Inline → Card → Embed).
If "Embed" is not available as a display option, the specific Google Drive file type may not support embed rendering — try re-sharing the video with a direct Google Drive link (not a shortened or shared-folder link).
Was this helpful?