• Products
  • Documentation
  • Resources

Insert the Google Drive macro

This macro is only available for the legacy editor. Learn more about editor versions.

Example of a Google Drive macro

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

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.

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. When editing, select from the toolbar

  2. Find the macro by name and select it

  3. Configure it as needed

You can also type / on the page to bring up the same list you'd see by selecting from the toolbar. Continue typing the name of the macro to filter the list.

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

  1. Select the macro placeholder.

  2. Select the Edit icon to open the configuration panel.

  3. Configure the parameters. Your changes are saved as you go.

  4. Resume editing the page, and the panel closes.

You can also select the centered , medium-width , and full-width icons to adjust the width of some macros. Select the trashcan iconto remove the macro.


Parameters are options that you can set to control what and how content from the macro appears on the page. 

If the parameter name used in Confluence Cloud storage format or wikimarkup is different than the label used when inserting macros using the browser or the slash command, it will be listed below in brackets (example).




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

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

Floating toolbar presented when selecting a macro while editing

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. Select the wheel icon () in the top-right corner to open Confluence administration.

  2. Find Settings in the left-hand navigation.

  3. Select Atlassian Marketplace > Find new apps.

  4. Search for Google Drive for Confluence.

  5. 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. 

Additional Help