Mentioning someone in a comment

Posting a comment doesn't email anyone. It waits to be found. An @-mention is how you make a comment reach a person: type @, pick a name, and once the comment is posted that person gets an email with the comment in it and a link straight back to the transaction or return. It works in every comment box, whether you are talking to a colleague or to the client.

How to mention someone

Comments appear on transactions, on a GST return's Activity tab, and inside a reply to an existing thread. Start one and type @.

A list appears in two groups: Your team, the people in your practice with access to this client, and Clients, the client-side users on this entity.

  • Keep typing to filter. Before you type anything, the list leads with the people you mention most and most recently. Once you start spelling a name, the closest match wins instead.
  • Pick with the keyboard or the mouse. ↑ and ↓ move, Enter or Tab selects, Esc dismisses the list and leaves what you typed as ordinary text.
  • Backspace removes the whole mention, not one letter of the name. A mention behaves as a single unit once it is in.
  • You can't mention yourself, so you never appear in your own list.

The list only ever contains people who already have access to that client. That means mentioning someone from Clients is a deliberate act. They will get the email and they can read the comment. If you are unsure whether the client should see it, remember that comments are visible to everyone with access to the entity regardless of who you mention.

What a mention looks like once posted

Real mentions render in bold. Click one to see who it is.

Names are fixed at the moment you mention someone, the way they are in Slack. If a person's name changes later, old comments keep the name that was correct when they were written rather than quietly rewriting history.


The email people get

One email per conversation, not one per mention. Three quick comments on the same return, made within a couple of minutes of each other, arrive as a single message rather than three separate notifications. Mentions on two different things, say a transaction and a return, arrive as two emails, one for each conversation.

That short delay is also a grace period. The email is assembled when it is sent, not when you hit Comment, so if you fix a typo, delete the comment, or the person's access changes inside that window, what goes out reflects the correction.

Each mention in the email links back to the exact transaction or return, so the recipient lands on the conversation rather than on a dashboard.

Replying by email

You can answer without opening Prosaic. Reply to the email and your reply is posted as a comment on that conversation, under your name, exactly as if you had typed it into the app. If the conversation had been resolved, your reply re-opens it.

Only what you write is posted. The quoted trail underneath is left out, so the comment reads as a comment rather than as a forwarded email. A sign-off usually survives, because it is part of what you wrote.

In the app, a comment that arrived this way is marked Sent via email underneath it. That is worth knowing when you read a thread back: whoever wrote it was answering a notification, without the rest of the conversation in front of them.

Sending a file back

Attach a file to your reply and it comes with it. The file is added to the comment and filed against the transaction, journal or return you are talking about, exactly where a file uploaded from the app would land. That is the short route from "can you send me the receipt" to having the receipt sitting on the transaction.

The usual limits apply: 20MB a file, up to 10 files on one reply, and the same file types as anywhere else in Prosaic. Two things are deliberately left out:

  • Images in your signature. A logo or a social icon in your sign-off is part of the email's layout rather than something you meant to send, so it is skipped and never appears in Files.
  • Anything Prosaic can't take, such as a file type that isn't allowed or one over the size limit. It is left off quietly rather than stopping the reply, so check the conversation if you expected a file to arrive.

You don't have to write anything to send a file. Reply with attachments and no words, and the filenames become the comment, which reads better than the subject line would.

Reply from the address the email arrived at. Prosaic checks that the sender is the person who was mentioned, so a reply sent from a different address is not posted, and neither is one sent by a colleague the email was forwarded to. Gmail's own variations on a single address, extra dots and a +something  suffix, are treated as the same person. Nothing bounces back to say a reply was refused, which makes the sending address the first thing to check if a reply never appears.

What an emailed reply can't do

  • Formatting doesn't survive. The comment is the plain text of what you wrote, so bold, tables and images pasted into the body are lost. Send a picture as an attachment instead.
  • You can't mention anyone. Typing @Sam in an email is only text, so an emailed reply never sends anyone an email of their own. Open the conversation in Prosaic when you need to pull someone else in.
  • A very long reply is trimmed. A comment holds 2,000 characters, and anything past that is cut with a note in its place saying so.
  • Out of office replies are ignored, so an automatic response to a mention email doesn't land in the thread as a comment.

Turning mention emails off

Go to Settings → Notifications and switch Mentions off.

Every mention email also carries an unsubscribe link in its footer, which does the same thing in one click. It only ever turns off mention emails. Nothing else Prosaic sends you is affected, and you can switch them back on from Settings → Notifications at any time.

Clients have the same setting on their own account.


Where mentions don't work yet

  • The bulk comment box. Commenting on several selected transactions at once (⌘ + K → Comment on n selected) uses a plain box with no @, because the selection can span more than one client and there is no single list of people to offer.
  • A mention uses up some of the 2,000-character limit, roughly 50 characters each, since the counter measures what is stored rather than what is displayed. Only worth knowing if you are close to the limit.
  • Email only. There is no notification centre in the app yet, so a mention reaches someone through their inbox or not at all.

Need help?

For what comments themselves can do, including resolving, exports, and what your client sees, see Comments. If mention emails aren't arriving, or you want to tell us what you'd rather they said, click the 💬 button in the app or email help@prosaic.works.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us