Using Box for Google Workspace Add-on is simple and fast. Box for Google Workspace Add-on brings your secure Box content repository directly into your Gmail interface, enabling you to store email attachments and messages directly into the Box folder of your choice. It also enables you to insert shared links to your Box files anywhere within the body of your email message, so you can share your Box content with anyone you wish while fully retaining any security policies that exist around the actual files. Additionally, it enables you to browse your Box files and folders from the GDrive home page, and copy Google files (Docs, Sheets, and Slides) in Google Drive to the Box folder of your choice.
Here's a quick overview:
Getting Box for Google Workspace Add-on
Box for Google Workspace Add-on is an add-on you can install and deploy like other Google Workspace Add-on add-ons. Your organization’s Google Workspace or Box administrator may already have made the Box for Google Workspace Add-on integration available to you via an enterprise-wide deployment. If that is the case, when you open Gmail or GDrive you should see a Box icon displayed in the third-party application sidebar on the right of your Gmail or GDrive interface, or within Google editors themselves (Docs, Sheets, Slides).

You do not see the Box icon if:
- your Box admin has left it up to you to decide to install Box for Google Workspace Add-on to your Google account. The admin still must have enabled the integration for you to install it on your own.
- you use a free Box account, and need to install the integration to add Box to your Google Workspace Add-on account.
In either case you can get it, yourself.
To install Box for Google Workspace Add-on and add Box to your Google Workspace account
- Open Gmail, GDrive, or Google Calendar. In the third-party application sidebar that displays on the right, at the bottom, click the + sign. The Google Workspace Marketplace displays.
- Search or scroll down to find Box for Google Workspace Add-on, and then click Install.
- Follow the prompts, until the Box icon displays in the third-party app sidebar.
Note
If you receive an error when you follow this procedure, your admin has disabled the Box for Google Workspace integration for your entire enterprise.
Using Box with Google Workspace Add-on for the first time
- Open Gmail and create or open a message as you normally do.
- Click the Box icon in the righthand sidebar. A Box pane opens on the right.
- At the prompt, click Authorize Access.
- At the next prompt, click your Gmail account.
- At the next prompt, click Allow. This allows the integration to access certain functionality, such as your location settings and your Gmail information about your Gmail account.
The Box pane refreshes. This is where you log into Box via Gmail.
- Click Log in.
- At the next prompt click Grant Access to Box.
The Box pane refreshes again. Now you can use Box from directly within Gmail to save attachments, save messages, or send links. From within the Box pane you can browse and view Box files and folders without leaving Gmail or even closing your current email message.
To save Gmail message attachments in Box
- In Gmail, select or open the message you want. The Box pane on the right displays with any attachments the Gmail message may have.

- Do one of the following:
- To save all of your attachments, click Save Attachments.
- To save only specific attachments, clear the checkbox of each attachment you do not wish to save. Then click Save Attachments.
- The Box pane displays a single-column list of all your Box folders in your All Files page. It also displays folders in your Recents and your Favorites pages. Scroll through the list until you find the folder you want. Click the folder to open it and access any sub-folders.
-
- Folders are color-coded here just as they are in Box. Also, all Box file permissions apply.
- Save the attachment to the folder you selected. To do this, click Save to [[Folder Name]].

- The Box pane displays a confirmation message. Click View to work with the file just as you would with other files in Box – that is, edit it, share it, invite collaborators, and so on.
- (Optional) To comment on the file you’ve saved, in Box Preview, in the Activity pane on the right, type in any message you want and click Post.
You can also open an attachment in its native application. To do this, in the Box pane, click the open file icon (
).
Note
If you do not select a mail message, the Box Pane still displays, but is empty.
To save the Gmail message itself in Box
- In Gmail, open the message you want. The Box pane on the right displays with any attachments the Gmail message may have.
- Click Save Email as .TXT File.
- The Box pane displays a single-column list of all your Box folders. Scroll through the list until you find the folder you want. Click the folder to open it and access any sub-folders.
- In the same way you saved the message attachment, locate the folder you want and click Save to This Folder. This saves the body of the email message (plus basic message information such as Sent From and Time) as a new file within the Box folder you selected.
-
- Typically you’ll save the email message body in the same folder as the attachment.
- In the same way you viewed your attachment, click View. This opens the newly-created text file in Box Preview.
Tip
To see how the message would look in a browser, copy the permalink in the body of the text file and paste it into the address bar of a new browser tab or window.
You can use Gmail to send any of your Box files to anyone else, safely and securely. The permissions and privacy settings on the file persist, so no one can access the file who isn’t authorized to do so. Before you click Send, Box prompts you to assign access permission to the recipient – if you have the permission to do that. But you can’t send a shared link to a file you don’t have permission to share at all.
The link displays as a discrete object within the body of the email, so you can move it around within the body of the email message.