team-files-vs-confluence-1
Confluence Smart Links Explained
See how they work, where they fail with external files, and more secure, consistent management alternatives.
Read more: Confluence Smart Links Explained
untitled_Flux 2 Pro_2026-03-26_21-41-00
Jira SharePoint Integration
Discover how to sync files, automate folders, and enhance collaboration in Jira Cloud and Data Center.
Read more: Jira SharePoint Integration
Porto-pic
About us
From the start, our goal has been to remove the hidden friction that prevents teammates from collaborating easily on the files that matter most. We believe productivity is not about adding more tools but making the ones you already use work together seamlessly. Based in Porto, ikuTeam builds the invisible layer for the Atlassian ecosystem to dissolve file silos and help over a million users stay focused and move faster.
Read more: About us
team-files-vs-confluence-1

Confluence Smart Links Explained

See how they work, where they fail with external files, and more secure, consistent management alternatives.
Read more: Confluence Smart Links Explained
untitled_Flux 2 Pro_2026-03-26_21-41-00

Jira SharePoint Integration

Discover how to sync files, automate folders, and enhance collaboration in Jira Cloud and Data Center.
Read more: Jira SharePoint Integration

About us

From the start, our goal has been to remove the hidden friction that prevents teammates from collaborating easily on the files that matter most. We believe productivity is not about adding more tools but making the ones you already use work together seamlessly. Based in Porto, ikuTeam builds the invisible layer for the Atlassian ecosystem to dissolve file silos and help over a million users stay focused and move faster.
Read more: About us
Porto-pic
Product Documentation

Nov 19, 2026

2.2 Attaching files and folders to work items

Learn how to attach files and folders to your work items with the ikuTeam Files for Jira.


About the ikuTeam Files for Jira app

With the ikuTeam Files 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.


Adding the ikuTeam Files for Jira app to the work item

By default, Jira hides installed apps. So, the first step is to add the ikuTeam Files app to your work item.

Instructions:

  1. Open the work item.

  2. Click the view app actions button above the work item description.

  3. Select ikuTeam Files.

Screenshot: Attaching Files and Folders to Work Items: Add App

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


Selecting the files and folders to attach

Instructions:

  1. Click the “Attach/Remove” button.

Screenshot: Attaching Files and Folders to Work Items: Configure
  1. Browse your connected folders in the ikuTeam Files dialog. If you haven't connected any folders, you can do so now. You can connect more folders from the context menu.

Screenshot: Attaching Files and Folders to Work Items: Add Files
  1. 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.

    Screenshot: Attaching Files and Folders to Work Items: Add Files
  2. 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.

    Screenshot: Attaching Files and Folders to Work Items: Add Tags
  3. Optional: click the “Layout” tab to customize how attachments look on your work item.

  4. Click the “Done” button.

All done. Your attached files and folders are now visible on the work item.

Screenshot: Attaching Files and Folders to Work Items: App

Attaching files and folders from the file manager

In Jira, you can attach files and folders to your work items directly from the file manager, in the ikuTeam Files tab of your Jira space.

Instructions:

  1. In the file manager, navigate your connected folders until you can see the file or folder you want to attach to a work item. 

Screenshot: Attaching Files and Folders to Work Items: Browse Files
  1. Open the context menu of the file or folder to attach.

Screenshot: Attaching Files and Folders to Work Items: Browse Files
  1. Click the "Attach to work item" option.

Screenshot: Attaching Files and Folders to Work Items: Attach Work Item
  1. 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.

Screenshot: Attaching Files and Folders to Work Items: Attach Work Item
  1. 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.


Customizing the layout

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.

Screenshot: Attaching Files and Folders to Work Items: Customizing Files

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.

Screenshot: Attaching Files and Folders to Work Items: Add Tags

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.


Attachment header

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.


Preview height

Select the height for the preview:

  • Regular: The standard height for previews (464px);

  • Custom: Define a value for the height of the preview area.

Preview width

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.


Preview default visibility

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.


Removing attached files and folders

You can remove specific files and folders attached to a work item at any moment.

Instructions:

  1. Click the “Attach/Remove” button.

Screenshot: Attaching Files and Folders to Work Items: Configure
  1. Click the “Unlink” button on the files and folders you want to remove.

Screenshot: Attaching Files and Folders to Work Items: Disconnect
  1. 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.


Hiding the app

You can also hide the entire app on the work item page while keeping all the files and folders attached.

Instructions:

  1. Click the context menu in the top right corner.

  2. Click the “Remove” option.

Screenshot: Attaching Files and Folders to Work Items: Remove

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


Wrap up

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.