Issues, rich text, attachments & replies

What does an issue have?

• Type: epic, task, subtask (needs a parent) or bug
• Priority in five levels: Highest, High, Medium (the default), Low and Lowest — filter and sort by it
• Status, assignee, reporter, story points, sprint, labels and parent
• Who created it and who changed it last, and when (the ⓘ button) — recorded for you
• Links: blocks / blocked by, relates, duplicates and clones — the inverse link is written on the other issue for you
• A rank: its order on the board and in the backlog

Fields save as soon as you change them, like Jira: pick a status, assignee, priority or sprint and it is saved. Points and parent, which you type, save when you press Enter or leave the box. Each change is one new version and shows in the issue history.

Only the description waits for Save (or ⌘S) — text you are still writing is never saved along with a field. Ticking a checklist item in the description saves at once.

A field that was just saved shows “Saved” next to its name for a moment. The New issue form starts as a Task every time and says what each type is for.

How do I see sub-tasks and the parent?

Every issue's drawer has a “Sub-tasks” section: how many there are, an x/y done bar, and each child's key, title, status and assignee. Click a key to open the child; the list updates live when someone changes a status or adds a child. A Sales & Billing deal has no such section — it lists its installments instead.

The parent's key in the drawer header is a link that opens the parent — one click up the hierarchy. Parent and child is not a link (blocks, relates and so on); it is set in the Parent field.

AI agents list a parent's children with search_issues parent=KEY.

How do I write descriptions and comments?

In a WYSIWYG editor: headings, bold, italic, strikethrough, code, lists, checklists, tables, links, quotes, code blocks (including mermaid) and dividers. Markdown shortcuts work as you type, and images you paste, drop or insert show inline at once while they upload.

Everything is saved as Markdown in the .md file — parts you did not touch are written back byte for byte. Prefer raw Markdown? Open the Markdown tab, or view the whole .md file.

Highlighter and text colour (use sparingly — bold, headings and lists stay the main formatting): select text in a description, comment or project doc and press the A button in the toolbar (text colour / highlighter), or ⌘⇧H (Ctrl+Shift+H) for the last highlighter colour. Five colours: yellow, green, red, blue and purple. Suggested meaning (a convention, not enforced): yellow = attention, green = passed or expected result, red = must fix, bug or actual result, blue = info or note, purple = question or to confirm.

In Markdown it is stored as an inline HTML pair: <mark>text</mark> (yellow highlighter) or <mark data-color="green">text</mark>, and <span data-color="red">text</span> for text colour. Any other HTML is shown as plain text, and the opening and closing tag must be in the same paragraph. AI agents write the same.

How are attachments handled?

Attach with the button or by dropping files; they upload straight to object storage. Each issue's attachments table shows a thumbnail, name, date added, size and uploader (badged when uploaded over MCP), filters All, Images, Documents, Videos and Other, and offers preview and download.

Delete a file with the trash button next to Download: the uploader deletes their own files, a company admin any file, viewers never. You confirm first, then it is gone for good (no restore); links to it in the description and comments show “file deleted”. AI agents over MCP (delete_attachment) delete only files their own token uploaded.

Storage counts per company, with 10 GB free; see your usage in the admin console.

How do comment replies work?

Press Reply under any comment and the composer opens under its thread. Replies are grouped under the top-level comment (one level deep); a reply to a reply shows whom it answers with a short quote. Threads over 3 replies collapse, and every comment has its own link.

Authors can edit their own comments; an edited comment shows “(edited)” — click it to see the edit history — and editing sends no extra email. The author or a project admin can delete a comment: “This comment was deleted” stays in its place and the replies remain; the old text stays in the issue history.

How do I watch an issue?

Press Watch in the issue drawer (or press w while the drawer is open) to get an email when the issue changes status or gets a new comment; press it again to unwatch. The number next to the button is how many people watch it — click it to see who.

• Anyone who can open the issue can watch it, viewers included
• Commenting on an issue watches it for you, like Jira
• Watching is yours alone: it does not change the issue, add a version or show in the history
• People who lose access to the project stop getting emails, and deleting an issue removes its watchers
• AI agents watch for their token's user over MCP (list_watchers, watch_issue, unwatch_issue)

The first time a comment makes you a watcher, a notice says you now watch the issue and what emails you will get.

How do I @mention someone?

Type @ in a comment or an issue description and pick someone from the project's members — in rich text and in the Markdown tab. The name shows as a chip and that person gets an email. In a description, only people newly added when you create or edit the issue are emailed, not those mentioned before.

In Markdown a mention is stored as the link [@Name](mention:usr_…) — the user id decides who is emailed; the name is only for display. AI agents write the same in add_comment. Only people who can open the project are emailed, at most 50 per message.

When do I get emails?

• Never about your own actions
• At most one email per person per event — when several apply, you get the first one you have on, in this order: reply, mention, assigned, status change, new comment, other change
• Emails carry English and Thai in one message, and say when the change came from an AI agent
• Being added to a project is its own event, outside the order above, and also shows in the bell (click it to open the project)

What shows in the bell?

The bell at the top right keeps your notifications for 30 days in each company — you still see them after a reload, in a new tab or on another device, including what happened while the app was closed. Unread entries are highlighted with a dot — opening the bell does not read them: clicking an entry reads that one, and Read all reads the rest (every tab follows at once). Show older loads earlier ones.

• Issues you are assigned to, reported or watch, @mentions and replies to your comments — the same people as the email table above, but the bell always shows them, even with that email turned off
• Handoffs to you, being added to a project, the BoardMark team's answers to your Support cases, and a project you can restore being deleted, restored or about to be deleted for good
• Notices from BoardMark — legal notices (changes to the Terms of Service or the Privacy Policy) and service announcements such as planned maintenance: one entry in every company you belong to, and opening it in one company reads it in all of them. A legal notice stays highlighted until you click it open — Read all does not clear it — and stays in the bell for 90 days, or until 30 days after it takes effect if that is later. Notices also arrive by email; with no company yet you get the email only
• Company admins also see: new projects, people who accepted an invitation and joined, members added, Jira imports starting and finishing, coupons and plan upgrade requests
• Never your own actions (except when your own Jira import finishes), and not changes to issues that do not concern you — the board still updates live as before

How do I turn emails off?

Open Settings → Email notifications and switch each kind on or off; it saves at once and applies to every company you belong to. Every email you can turn off ends with a link to turn off that kind (sign in, then confirm with one click — Undo is there) and a link to manage all your notifications.

Always sent, cannot be turned off: invitations to a company (being added to a project is a switch like the others); invoices, payments and coupons (company admins); emails about a deleted project or company and the reminder before it is deleted for good; account emails such as email verification, password reset and account security; and legal notices from BoardMark when the Terms of Service or the Privacy Policy change.

Service announcements from BoardMark (planned maintenance and changes to BoardMark) go to every account with a verified email, in one email with English first, then Thai. Turn them off in Settings → Notifications → From BoardMark → Service announcements (on by default, email only — never LINE or your devices), or with the link at the bottom of an announcement, which needs no sign-in: the page it opens changes nothing until you press Turn off these emails. With them off, legal notices still reach you, and the switch does not change the bell.

Can I get notifications on LINE? (Premium)

Yes, once you belong to at least one company on Premium: link LINE in Settings → Sign-in methods and add the BoardMark LINE Official Account as a friend (LINE offers it when you link, or add it later). Settings → Notifications then turns on a LINE column next to email, with the same kinds as the email table above and the same defaults (all on except other issue changes). If the column is not usable yet, the page says why: not linked, not a friend, or no Premium company.

• LINE messages are sent only for events in companies on Premium; other companies keep emailing by your switches
• One LINE card per event per person, in English and Thai, with a button to open the issue (or the project, when you were added to one) and a link to turn off that kind on LINE (sign in, then confirm with one click)
• Emails that are always sent (invitations, invoices, payments, deletions and account security) stay email only — except two-step sign-in security alerts, which also go to LINE on every plan
• Messages typed into the BoardMark LINE chat are not read; an automatic reply points you to the web app or Support
• Unfriending BoardMark or unlinking LINE stops LINE messages, and so does the company going back from Premium to Pro — your switches are kept for later

Can I get notifications on Telegram? (Pro, Premium)

Yes, much like LINE: link Telegram once and you get notifications in a chat with the BoardMark bot, and you can sign in with Telegram. Linking takes three steps and under a minute.

• Open Settings → Sign-in methods and press Link Telegram (sign in another way first — you cannot sign up with Telegram)
• Accept in Telegram: let BoardMark sign you in and let the bot message you. Your phone number is not shared
• Settings → Notifications now shows a Telegram column next to email, with the same kinds as the email table above and the same defaults as email

• Telegram work notifications need at least one paid company (Pro or Premium) and cover only events of paid companies; a company still on the free tier does not qualify. There is no per-message cost. When it cannot be used yet, the page says what is missing: not linked, the bot is blocked, or no paid company (every company of yours is still on the free tier)
• One event is one message per person, English first then Thai in the same message, with an open button and a “Turn off this kind” button (sign in, then confirm with one click)
• Account security alerts also arrive on Telegram, on every plan, and cannot be switched off
• Service announcements from BoardMark go by email only; there is no Telegram switch for them
• If the bot stops messaging you: if you blocked or stopped it, Settings shows it as blocked. Open the bot in Telegram and press Start — your choices are kept
• Unlink in Settings → Sign-in methods → Disconnect, or send /unlink in the bot chat and confirm. It is refused when Telegram is your last way to sign in (set a password or link another method in the web app first). After unlinking, BoardMark deletes the stored Telegram id
• Other text typed into the bot chat is not read by anyone; the bot replies once to point you to the web app or Support

Can I get notifications on my devices?

Yes, on every plan. Device notifications (Web Push) pop up in the corner of the screen or on your phone even when no BoardMark tab is open. Turn them on in Settings → Notifications → Notifications on this device → Turn on for this device, then press Allow when the browser asks. The Device column next to email (and LINE) then works, with the same kinds as the email table above; its switches apply to every device you turned on and start like LINE (all on except other issue changes).

• Works in Chrome, Edge, Firefox and Safari on computers and Android, on up to 10 devices per account; Send test shows a sample on this device and Remove stops it
• iPhone and iPad (iOS 16.4 or later): in Safari tap Share → Add to Home Screen, open BoardMark from that icon, then turn notifications on in Settings → Notifications — Apple only lets web apps on the Home Screen send notifications
• Blocked by mistake? Click the lock icon next to the address → Notifications → Allow, then reload
• Send test shows nothing? Your system may hide it: on a Mac, System Settings → Notifications → your browser (Chrome can be listed twice — set both) → Alert style Temporary or Persistent, and turn Focus / Do Not Disturb off; on Windows, Settings → System → Notifications → turn your browser on
• A notification reads like [APP-123] who did what, with the issue title; click it to open the issue (in an open BoardMark tab if there is one), and it has its own button to turn that kind off. Notifications about the same issue replace each other instead of piling up
• When a BoardMark tab is open and in front on that device, nothing pops up — the bell shows it
• In the language the app was in when you turned the device on; never about your own actions; emails that are always sent stay email only