How to embed a Google Doc to a Confluence page using the HTML macro

Still need help?

The Atlassian Community is here for you.

Ask the community

Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.

Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible


HTML macros are disabled by default

The HTML macro will only be available if it has been enabled by an administrator. Enabling these macros can make your Confluence site vulnerable to cross-site scripting attacks. More details on HTML macro can be reviewed in the following document:

To add a Google Doc to a Confluence page using the HTML macro perform the following:

In Google Drive/ Google Doc
  1. Navigate to Google Drive
  2. Edit the Doc
  3. Under File choose: Publish to the web
  4. Publish the document by clicking the Start Publishing under the Published content & settings section.
  5. Ensure that the Automatically republish when changes are made is enabled so that the document republishes every-time there is any change in the document.
  6. Click the Embed tab and copy the <iframe>.
In Confluence
  1. Ensure that the is in the Allowlist. This will allow Confluence to accept content from that domain.
  2. Once done, head over to a Confluence page and click Edit
  3. Add a HTML Macro
  4. Paste the <iframe> you've copied from step #6 above. 
  5. Edit the <iframe> to include the width and hight properties. Your <iframe> would look like something like the following: (you can adjust the hight and width, based on your needs.

    <iframe src="" width="1000" height="500"></iframe>
  6. The document will be displayed in Confluence. Updates to the document will also be displayed.

Related Articles

Last modified on Aug 11, 2021

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.