How to embed a Google Doc to a Confluence page using the HTML macro
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
- Navigate to Google Drive
- Edit the Doc
- Under File choose: Publish to the web
- Publish the document by clicking the Start Publishing under the Published content & settings section.
- 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.
- Click the Embed tab and copy the <iframe>.
In Confluence
- Ensure that the https://docs.google.com/ is in the Allowlist. This will allow Confluence to accept content from that domain.
- Once done, head over to a Confluence page and click Edit
- Add a HTML Macro
- Paste the <iframe> you've copied from step #6 above.
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="https://docs.google.com/document/d/e/XXXXXXXXXXXXXXXXX/pub?embedded=true" width="1000" height="500"></iframe>- The document will be displayed in Confluence. Updates to the document will also be displayed.