The comment editor
Formatting, tables, code, mentions and attachments — everything the editor on each composer can do, with its shortcuts.
Everything you write is posted as native Jira formatting, so a comment sent from here is indistinguishable from one typed into Jira itself — same headings, same tables, same code blocks, same file cards. The toolbar and the keyboard shortcuts deliberately mirror Jira's own editor, so there is nothing new to learn.
Shortcuts below are written in Mac notation. On Windows and Linux read ⌘ as Ctrl, ⇧ as Shift and ⌥ as Alt. The app detects your machine and shows the right one in every tooltip.
Headings
The dropdown at the far left of the toolbar sets the current block. It shows what you are currently in, so you can always tell whether the cursor is inside a heading.
| Block | Shortcut |
|---|---|
| Normal text | ⌘⌥0 |
| Heading 1 through Heading 6 | ⌘⌥1 … ⌘⌥6 |
Text formatting
| Control | Shortcut |
|---|---|
| Bold | ⌘B |
| Italic | ⌘I |
| Underline | ⌘U |
| Strikethrough | ⌘⇧S |
| Subscript | ⌘, |
| Superscript | ⌘. |
Inline code | ⌘⇧M |
| Text colour — 28 Atlassian palette colours, plus Remove colour | Toolbar A button |
| Undo / Redo | ⌘Z / ⌘Y |
Lists, quotes and dividers
| Block | Shortcut |
|---|---|
| Bullet list | ⌘⇧8 |
| Numbered list | ⌘⇧7 |
| Task list — checkboxes your team can tick off on the issue, and they nest | ⌘⇧6 |
| Quote | ⌘⇧B |
| Divider | Type /divider |
Tables
The table button opens a size grid — drag across it to choose how many rows and columns you want. Once the cursor is inside a table, a second row of controls appears with everything you need to reshape it:
- Header row and Header col — toggle either independently, so a table can have a header row, a header column, both, or neither.
- Add columns before or after the current one, and add rows above or below.
- Delete table to remove the whole thing in one click.
Code blocks
A code block keeps your indentation and monospacing intact, and carries a language selector with 42 languages — Bash, C, C++, C#, CSS, Dart, Go, GraphQL, Groovy, Haskell, HTML, Java, JavaScript, JSON, Kotlin, Python, Ruby, Rust, SQL, TypeScript, YAML and more, plus (None) for plain text. The language travels with the comment, so Jira highlights it correctly on every issue you post to.
Slash commands
Type / anywhere in the editor to open a command palette, exactly like Jira's. Keep typing to filter the list, move with the arrow keys, and press Enter to insert. Twelve commands are available, so you never have to reach for the toolbar mid-sentence:
| Command | What it inserts |
|---|---|
/image · Image, video, or file | Attach a file to this comment |
/heading 1 | Large section heading |
/heading 2 | Medium section heading |
/heading 3 | Small section heading |
/bullet list | Unordered list |
/numbered list | Ordered list |
/task list | Action items with checkboxes |
/quote | Blockquote |
/divider | Horizontal rule |
/code block | Code snippet with language selector |
/table | Opens the size picker |
/emoji | Opens the emoji browser |
It matches on synonyms. The attachment command is called “Image, video, or file”, but /screenshot, /upload, /photo, /media, /attach and /video all find it. The palette opens mid-sentence, not just at line start.
Mentions, links and emoji
- @mentions — type
@; a bare@lists teammates. Only people are suggested — apps and service-project customers are filtered out. Mentioned people are notified on every issue the comment lands on, which is why a mention always asks you to confirm first. - Smart links — paste a Jira or Confluence URL and it becomes a live card showing title, status, priority and assignee, fetched fresh. Click it for a Display as menu: URL, Inline, Card or Embed.
- Emoji — browse from the toolbar or type
/emoji.
Attachments
Attach files three ways: drag them into the editor, paste a screenshot straight from the clipboard, or use the toolbar button. Dropping a file places it where your pointer is, not where the cursor happened to be.
- Up to 150 MB per file, with no limit on how many files one comment can carry. If your Jira site sets a lower attachment limit, that one wins — the app reads the site's real limit and checks against it the moment you attach, so an oversized file is refused immediately rather than after you have written the comment.
- Uploading starts on attach, not on Send. The file moves while you are still typing, so the send itself is usually near-instant — the attachment shows Uploading… while it goes, or Will upload when you send if it could not start early. Nothing is visible on any issue until you actually send, and anything you attach and then delete is discarded.
- Images and video preview inline, align left, centre or right, and resize by dragging the edge — the same handles Jira gives you. PDFs and other documents post as file cards.
- Large files upload through an async queue in the background, so a long video posting to 25 issues does not block the send while it uploads.
- A file is refused the moment you attach it, not at send, and the message names which limit bound — your site's, or the app's 150 MB. The oversized file is dropped; the rest of the batch still attaches.
- Select an attachment and a toolbar appears on it — align, card or inline, reset, download, full size, duplicate, remove. Images and video resize by dragging their edge; the width is stored as a percentage, so it scales in whatever width the reader's Jira gives the comment.
- Duplicating an attachment costs nothing. The copy points at the same upload, so putting one screenshot in two places in a comment does not upload it twice.
- Previews are generated on your own machine — nothing is sent anywhere to make them. Video gets a poster frame and a player with ±10 seconds, speed and fullscreen; a PDF shows page one; logs, CSVs and code show their first twelve lines; anything else gets a typed file card.
- Removing an attachment releases it. The staged copy is deleted straight away rather than sitting in storage until it expires. And a draft reopened after a reload keeps the attachment’s place but not its bytes — it reads re-attach — file not kept after reload, and correctly does not count as something to send.
- A whole send is capped at 2 GB across the batch — separate from the 150 MB per file, so every file can be inside its own limit and the send still be refused. Four 120 MB files to 5 issues is 2400 MB and will not send. See Limits.