• 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 item to be inserted and select it

  3. Select Insert

You can also type / on the page to bring up the same list you'd see by selecting from the toolbar.

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. The floating toolbar appears.

  2. Select Edit. The right panel opens.

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

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

Parameters

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

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

Parameter

Default

Description

Google Drive URL

none

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

 

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'

yes

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

Additional Help