What's New in 2.2.0
Safe saves when several people edit the same file, with side-by-side compare and merge.
- Protected saves: before overwriting a file, the editor checks whether someone else saved a newer version since you opened it. If so, nothing is overwritten: you see their version next to yours, combine them, and choose how to save.
- Deleted files: if someone removes the file while you edit, your text is kept and you can save it as a new file.
- Read-only viewing: people who can see a work item but not add attachments can now open its text files to read them.
- Who and when: the file list and the editor show who saved each version and when.
- Keyboard save: Ctrl+S (Cmd+S on Mac) saves.
- File types kept: saving keeps the original file type instead of turning every file into plain text.
- Faster panel: the file list loads without the editor, and the editor's language features run in the background, so typing stays smooth on large files.
Overview
Attachment Text Editor for Jira lets you open and edit text-based attachments (CSV, logs, config files, source code, and more) directly on the issue view. Say goodbye to the tedious process of downloading a file, editing it locally, and re-uploading it. Quickly review and update files in context without ever leaving Jira.
Key Features
In-Browser Editing
Open text files in a full-screen, IDE-like editor directly inside your Jira issue.
Syntax Highlighting
Automatic syntax colorization for over 20 popular programming languages and config file formats.
Create & Duplicate
Create brand new files from scratch, or use "Save as copy" to safely edit without destroying the original.
Safe Team Editing
If a teammate saved the file while you were editing, compare both versions side by side and combine them instead of overwriting.
Permission Aware
Edit, save a copy or just read, depending on your attachment permissions.
Enterprise Security
Built strictly on Atlassian Forge. Eligible for the Runs on Atlassian program with zero external data egress.
How It Works
Unlike complex automation apps, there is zero backend configuration required. The app works straight out of the box, but you do need to enable the panel on your view first.
- Navigate to any Jira issue.
- Enable the App Panel: Click on the Gear icon next to the work item's Summary and enable Attachment Text Editor from the list as shown below.
- Pin to Issue View (Optional but recommended): When the app is shown between the file list and comment section, you can click on the three dots (...) on the right side of the panel and enable it to show for all work items.
- The Text files panel now lists the text and code attachments on the work item, with their size and who saved them and when.
- Next to each file, click Edit (you may replace the file), Open (you may add attachments, so you can save a copy) or View (read only). Click New file to draft a new attachment and pick its language.
- When finished, click Save (or press Ctrl+S / Cmd+S) to update the file, or Save as copy to keep the original.
Note: The app dynamically respects your Jira project permissions. If you do not have permission to delete an attachment, the app will prevent you from overwriting it, but you can still save your changes as a copy.
Editing the Same File Together
Jira attachments cannot be changed in place, so saving a file means attaching the new version and removing the old one. To make sure nobody's work is lost, the editor remembers the version you opened and checks the work item again at the moment you click Save:
| Since you opened the file… | What happens |
|---|---|
| Nobody changed it | Your version is saved. |
| Someone saved a newer version | Nothing is overwritten. Their version appears on the left and yours on the right. Edit the right side to combine both, then choose Save combined version, Keep editing on top of theirs, or Save mine as a copy. |
| Someone deleted the file | Your text is kept and you can Save it as a new file. |
Supported Languages
The editor automatically detects the file extension and applies the correct syntax highlighting. You can also manually select a language when creating a new file. Supported formats include:
- Source Code: C, C++, C#, Go, Java, JavaScript, PHP, Python, Ruby, Rust, TypeScript
- Web & Scripts: HTML, CSS, Shell / Bash, PowerShell, SQL
- Data & Configs: JSON, XML, YAML, Markdown, CSV, Plain Text (.txt, .log, .env, .ini)
Troubleshooting & Limitations
- Why does a file say "Over 5 MB"?
- To ensure Jira remains fast and your browser doesn't crash, the in-browser editor is restricted to files 5 MB or smaller. Larger files must be downloaded and edited locally.
- Why does a file offer "Open" or "View" instead of "Edit"?
- To replace a file, Jira requires the Create Attachments permission plus Delete Own Attachments (if you uploaded it) or Delete All Attachments. With Open you can edit and save your changes as a copy; with View (no permission to add attachments) you can read the file.
- What happens if two people edit a file at the same time?
- Nobody's work is overwritten silently: whoever saves second sees the other person's version next to their own and decides how to combine them. See Editing the Same File Together. Only if two people press Save within the same instant do both versions end up attached, and nothing is lost.