About the Team Files app on Jira
With the Team Files app on Jira, you can attach files and folders to your issues to share knowledge with your team.
On this page, we’ll show you how to do just that, from the issue view and the file manager, helping you and your team to keep all the information updated and in one place. If you want to attach for your customers, check the Attach files and folders for customers on Jira Service Management Cloud page.
Attaching files and folders from the issue view
It’s straightforward to add the Team Files app to your issues, enabling you to attach files and folders for your team.
Adding the Team Files app to the issue
By default, Jira hides installed apps. So the first step is to add the Team Files app to your issue.
Instructions:
In the issue, click the “Attach items with Team Files” button, or the button with the Team Files icon, below the issue title.
And that’s it. The app will load below the issue description and will now always appear when you return to that issue page (but it’s possible to hide it again).
Keep in mind that you also need to add the app to the issue when you attach files and folders to issues from the file manager.
Selecting the files and folders to attach
With the app in place, you can now start attaching files and folders.
Instructions:
Click the “Attach file/folder” button.
Browse your connected folders in the Team Files dialog. If you haven't connected any, you can do that so now. You can also connect more folders from the context menu as you would in the file manager.
Select the files and folders you want to attach by clicking the checkbox. You’ll see them appear on the live preview pane on the right side.
Click the “Attach” button.
All done. Your attached files and folders are now visible on the issue.
Attaching files and folders from the file manager
In Jira, you can attach files and folders to your issues directly from the file manager, accessible from the sidebar.
Attach to issue
Instructions:
In the file manager, navigate your connected folders until you can see the file or folder you want to attach to an issue.
Open the context menu of the file or folder to attach.
Click the "Attach to issue" option.
Select the issue where you want to attach the file or folder. You can use the search field to look for a particular issue or even use the JQL search.
Click the "Attach" button.
All done. Your file or folder is now attached to the issue. You can click the "View issue" button to jump to the issue page.
You need to add the app to the issue page to view the attached files and folders from the file manager.
Removing attached files and folders
At any moment, you can remove specific files and folders attached to an issue.
Instructions:
Click the “Manage” button.
Click the “Unlink” button of the files and folders you want to remove.
Click the “Done” button to end the management mode.
All done. Your files and folders are safe and sound in your storage place but no longer connected to the issue.
This action is undoable, but you can attach the files and folders again.
Hiding the app
You can also hide the entire app on the issue page while keeping all the files and folders attached.
Instructions:
Click the context menu on the top right corner.
Click the “Hide Team File” option.
All done. Your files and folders are still attached to the issue but not visible. To show them again, add the app back.
Wrap up
Now you know how to attach files and folders to your issues. Don’t forget you can also attach files and folders for your customers (Jira Service Desk projects only).
If you still have questions about attaching files and folders to your issues, visit our support portal and send us your questions. Our team is always happy to help.