Nov 19, 2026
Learn how to attach files and folders to your work items with the Google Drive Connector for Jira app to share the knowledge with your team.
With the Google Drive Connector for Jira app, you can attach files and folders to your work items to share knowledge with your team.
On this page, we’ll show you how to do just that, from the work item view and the file manager, helping you and your team keep all the information updated and in one place. If you want to attach files and folders for your customers using JSM, check the 2.3 Attach files and folders for customers page.
By default, Jira hides installed apps. So, the first step is to add the Google Drive Connector for Jira app to your work item.
Open the work item, click the view app actions button above the work item description, and select Google Drive.


And that’s it. The app will load below the work item description and always appear when you return to that work item (but you can hide it again).
Remember to add the app to the work item when you attach files and folders from the file manager.
With the app in place, you can start attaching files and folders.
Click the “Attach/Remove” button.

Browse your connected folders in the Google Drive dialog. If you haven't connected any folders, you can do so now. You can connect more folders from the context menu.

Click the checkbox to select the files and folders you want to attach. They will appear in the live preview pane on the right side.

In Live Preview, you have an “Edit tag” button for files and folders. Select it to add a tag to any item, or to change or remove a tag you added earlier.

Optional: click the “Layout” tab to customize how attachments look on your work item.

Click the “Done” button.
All done. Your attached files and folders are now visible on the work item.
In Jira, you can attach files and folders to your work items directly from the file manager, in the Google Drive tab of your Jira space.
In the file manager, navigate your connected folders until you can see the file or folder you want to attach to a work item.

Open the context menu of the file or folder to attach.
Click the "Attach to work item" option.

Select the work item where you want to attach the file or folder. You can use the search field to look for a particular work item or even use the JQL search.

Click the "Attach" button.
All done. Your file or folder is now attached to the work item, and a confirmation message shows the work item key.
You need to add the app to the work item page to view the attached files and folders from the file manager.
By default, the files and folders attached to Jira work items use a regular header and appear in the collapsed view to use less space on the screen. It’s easy to preview the file by clicking the arrow to open the expanded view, which uses the width of the page and is 464px tall.
The Admin can set different defaults, and you can customize individual work items.

You can set different layout settings when attaching files and folders to your work item or, when you already have attached something, by clicking the “Attach/Remove” button and opening the “Layout” tab. You can preview the changes in the “Live Preview” panel. When you save the changes, you’ll see the new layout applied to your work item page.
In Live Preview, you have an “Edit tag” button for files and folders. Select it to add a tag to any item, or to change or remove a tag you added earlier.
A tag is a short label that sits next to the file or folder. It gives an item context that its name alone does not carry, for example Approved, Draft, Invoices, or a client or team name.

You can also change the header style and expand or collapse previews for your current view with the buttons in the app's toolbar. To save a layout for the work item, use the “Layout” tab.
Select the size for the header of the attachment:
Regular: The standard size for the header of attached files and folders. It shows a big icon and additional details;
Compact: Uses a smaller icon and only indicates the name of the file or folder;
Hidden for files: Completely hides the file header and forces the expanded preview option. Moving the mouse over the file will show a compact header.
Select the height for the preview:
Regular: The standard height for previews (464px);
Custom: Define a value for the height of the preview area.
Select the width for the preview:
Auto: The standard option. Previews use the full width of the page;
Custom: Define a value for the width of the preview area.
Select the behavior for the preview:
Collapsed: The standard option that hides the preview;
Expanded: Automatically shows the preview of files and folders. This option is required when selecting the “Hidden for files” header.
You can remove specific files and folders attached to a work item at any moment.

Click the “Attach/Remove” button.
Click the “Unlink” button on the files and folders you want to remove.
Click the “Done” button to end the management mode.
It's all done. Your files and folders are safe and sound in your storage place, but they are no longer connected to the work item.
This action can’t be undone, but you can attach the files and folders again.
You can also hide the entire app on the work item page while keeping all the files and folders attached.

Click the context menu in the top right corner.
Click the “Remove” option.
All done. Your files and folders are still attached to the work item but not visible. To show them again, click on the view app actions button and select Google Drive.
Now you know how to attach files and folders to your work items. Don’t forget you can also attach files and folders for your customers (Jira Service Management spaces only).
If you still have questions about the topics covered on this page, visit our support portal and send them to us. Our team is always happy to help.