Google Drive macros are provided by the Google Drive for Confluence app.

Your administrator will need to install this app before you can use these macros.

Embed Google Docs, Sheets, and Slides files from your Google Drive directly into your Confluence page.

To add one of these files from your Google Drive onto your page, paste the link into the editor and auto-convert will do the rest. Alternatively you can add the Google Docs, Google Sheets, or Google Slides macros to the page, edit the macro, and drop in the URL.

If the file is not public, Confluence will prompt people to authenticate with their Google credentials before they can see the file for the first time.

This app supports embedding Google Docs, Sheets, and Slides files, only. It does not let you embed other types of files you may have in Google Drive.

Using the Google Drive macros

To add a Google Drive macro to a page:

  1. In the Confluence editor, choose > Other Macros
  2. Find and select the required macro

Speeding up macro entry with autocomplete:

  • In the new editor - Type / and the beginning of an element (tool or things in the insert menu) to see a list of suggestions.
  • In the legacy editor - Type { and the beginning of the macro name to see a list of suggested macros.

Details are in Keyboard shortcuts, markdown, and autocomplete.

To edit an existing macro

Click the macro placeholder and choose Edit. A macro dialog window will open, where you can edit the parameters of the macro.


Parameters are options that you can set to control the content or format of the macro output.




Google Drive URL


This is the URL of your Google Drive file. You can get this URL from the address bar in your browser or using the Get Link option in Google Drive.


Height of the embedded document. Confluence will default to Google's preferred size for the type of file (doc, sheet, or slide).

Include a link to 'View in new tab'


Use this option to add a "View in new tab" button. It's a quick way for people to jump from viewing the file on your page to editing it in Google Drive.

To adjust the width of your embedded Google Drive file

Click the embedded file, then choose a width from the floating toolbar that appears:

This app is using the Google Drive v3 API. We try our best to stay in sync with their API updates. If they’ve recently updated their API, it’s possible you’ll see some unexpected behavior.

Installing the app

You'll need to be an administrator to install the app. 

To install the Google Drive for Confluence app:

  1. Navigate to your site settings by clicking Settings in the Confluence sidebar. 
  2. Click Find new apps in the Atlassian Marketplace section of the Confluence sidebar.
  3. Search for Google Drive for Confluence.
  4. Follow the prompts to install the app. 

Data Security and Privacy

In order to provide its services, the Google Drive for Confluence app saves the following configuration data:

  • Your confluence host key

  • Your Atlassian account ID

  • Your Google Drive API refresh token

  • Your Google Drive API access token

Google Docs content is not stored by the Google Drive for Confluence app.

Data in production instances of Google Drive for Confluence app is stored in Postgres databases in Amazon's cloud offering, protected by username/password credentials. No data is sent to services apart from Google Drive API, Google Drive for Confluence app, your Confluence instance and the infrastructure used by the Google Drive for Confluence app (currently Micros and Amazon).

All communications among the Google Drive API, Google Drive for Confluence app, and Confluence use HTTPS to prevent eavesdropping.

Revoking access

Users can revoke access to the Google Drive for Confluence app in their Google Apps account settings.