Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Excerpt

Learn how to preview and edit native attachments on Jira with the Team Files app.


Table of Contents


About the preview and edit

This page will cover how to preview and edit Jira attachments on your issues using the Team Files app without downloading files and reuploading multiple copies. You can preview and edit the most common Office document formats, PDF documents, and popular image formats.



Preview Files and Documents with Team Files

TF-JC-native 5.pngImage Added

  1. Disclosure button 

  2. Document info

  3. Edit document

  4. Full-screen Preview

  5. Download

When your Jira issue has native attachments, they appear automatically in Team Files when you add the app to the issue.

The Team Files app supports a full-screen preview and an inline preview, where you can actually see and read the content, unlike Jira’s thumbnails. Click the preview button or name of the file you want to open the preview for the full-screen preview or see the inline preview by clicking the disclosure button.


Edit Microsoft Office Files

You can edit Microsoft Office files directly from your issues. There is no need to download them to your computer or re-upload multiple copies.

TF-JC-native 2.pngImage Added

To edit a file, click the edit button in the file details or the full-screen preview header. The editor has an autosave feature, so you can close the tab when you finish.

Info

A real-time co-edit session will start if two or more users click Edit simultaneously.

Open Office files are also supported and work the same way as Microsoft Office documents, using the Microsoft 365 editor, but do not support real-time collaboration.


Layout options

All the layout options from Team Files are now available for your Jira Native Attachments, greatly expanding what’s possible in Jira. You can select the option to open the preview immediately when you open a Jira issue, customize the preview area, change the header style, or hide it completely. Check Customizing the layout for more details.

TF-JC-native 3.pngImage Added

Turning off the support for Jira Native Attachments

If you don’t want to use this feature, you can turn off the option in the “Layout” menu.

  1. Click the “Layout” button

  2. Click the toggle to turn the option off.

    TF-JC-native 4.pngImage Added

  3. Click the “Save” button to apply the changes.

Admins can also turn it off for all issues in the Admin settings. For more details, please check the Admin settings documentation.



Supported file formats for preview

  • Images: GIF, JPG, JPEG, and PNG

  • PDF documents (including password-protected files) 

  • Microsoft Office documents: DOC, DOCX, DOCM, XLS, XLSX, XLSM, XLSB, PPT, PPTX, PPTM, PPS, PPSX, PPSM

  • Microsoft Office templates: DOT, DOTX, DOTM, POT, POTX, and POTM

  • Open Office documents: ODT, ODS, and ODP

  • Rich text documents (RTF)

Preview of unsupported files

Image Removed
  1. Return to the file manager 

  2. Document information

  3. Download

  4. Open in [Storage]



The Team Files app can preview many popular file types, but not all of them. When you try to preview a file type not specified above, the preview window will open with the message "No preview available" and a "Download" button so that you can open it with your desktop apps

Supported file formats for edit

  • Microsoft Office documents: DOCX, DOCM, XLSX, XLSM, XLSB, PPTX, and PPSX

  • Microsoft Office templates: DOT, DOTX, DOTM, POT, POTX, and POTM

  • Open Office documents: ODT, ODS, and ODP

Info

We support preview of the old formats (.doc, .xls, .ppt), but only the new formats (.docx, .xlsx, .pptx) can be edited using Microsoft 365 editor. This is a Microsoft 365 restriction as the old formats are considered legacy. Also, some complex Word documents or some Excel spreadsheets with macros may not be possible to edit due to Microsoft limitations.



Wrap up 

That's all on previewing and editing native files.

If you still have questions about any of the topics covered on this page, visit our our support portal and and send them to us your questions. Our team is always happy to help.