Considering Confluence Cloud?
Get the high-level details of Confluence Cloud and available features by plan.
Insert the Google Drive macro
This macro is only available for the legacy editor. Learn more about editor versions.
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:
When editing, select from the toolbar
Find the macro by name and select it
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
Select the macro placeholder.
Select the Edit icon to open the configuration panel.
Configure the parameters. Your changes are saved as you go.
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
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 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:
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:
Select the wheel icon () in the top-right corner to open Confluence administration.
Find Settings in the left-hand navigation.
Select Atlassian Marketplace > Find new apps.
Search for Google Drive for Confluence.
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.
Was this helpful?
Still need help?
The Atlassian Community is here for you.