Ctrlk
Smaply websiteFree trial
For the complete documentation index, see llms.txt. This page is also available as Markdown.

How to comment on a card

Discuss any card in context by posting comments from its details panel and @mentioning the teammates you want to pull in.

Every card carries its own comment conversation, so feedback and questions stay attached to the exact step they're about. Open the card details panel, type in the Comments section, and press Enter to post. @Mention a teammate to notify them.

Commenting on cards is available on the Repository plan and above. On Free, collaboration is limited to a single journey map.

clipboard-list

In this guide

  1. How to add a comment to a card

  2. How to @mention a teammate

  3. How to delete a comment

  4. What a comment notifies

How to add a comment to a card

Comments live in the card details panel, which you open by clicking Show card details on the card toolbar, choosing Card details from the three-dot menu, or double-clicking the card. The panel works the same on every card type. For the panel itself, see How to add and edit cards.

1

Open the Comments section

In the card details panel, expand Comments. The heading shows the current count, so an untouched card reads Comments (0).

A card details panel with Personas, Card tags, and Comments sections. The Comments section is expanded and reads Comments (0), with an empty Add a comment field below it.
The Comments section on a card with no comments yet
2

Type your comment

Click into the Add a comment field and write your note. The field grows to fit longer text.

The Comments section with a comment being typed into the Add a comment field, reading Should we add a comparison of fee structures here? Customers ask about this a lot during research.
Writing a comment in the composer
3

Press Enter to post

There's no separate post button. Pressing Enter submits the comment, the count ticks up, and your comment appears with your name and the time you posted.

A posted comment under a Comments (1) heading, attributed to Smaply Team with a now timestamp and a delete icon, followed by an empty Add a comment field ready for the next comment.
A posted comment, with the empty composer ready for the next one

Comments stack in a single list, newest at the bottom, so a back-and-forth on a card reads in order. Anyone with access to the map sees the same conversation.

A Comments (2) section showing two comments in one list, each attributed to Smaply Team with a timestamp and a delete icon. The first asks about adding a comparison of fee structures; the second replies that the author will pull the current fee table and add it as a metric card. An empty Add a comment field sits below.
A two-comment conversation in the card's comment list

How to @mention a teammate

To pull a specific person into the conversation, type @ in the composer. A list of the people in your workspace opens, and picking one inserts a mention into your comment.

A comment composer with an @ typed in it. A dropdown below the field lists a workspace member, Smaply Team, with their avatar, ready to be selected as a mention.
Typing @ opens the list of workspace members to mention

Anyone who can comment can be mentioned, including teammates with Viewer access. The mention sends them a notification so they know to look. For what that notification is and where it lands, see What a comment notifies below.

How to delete a comment

Hover or look to the right of any comment for the delete (trash) icon, and click it to remove that comment. Deleting is the only edit available on a posted comment, and the count drops to match.

What a comment notifies

An @mention is the only comment activity that notifies anyone. The person you mention gets an in-app notification on the notification bell at the top-right of the app. There's no email for mentions, and a plain comment with no mention notifies no one.

For the full picture of what Smaply notifies you about and where, see About notifications.

Related topics

How to add and edit cards

Parent how-to for the card details panel and the shared mechanics every card type uses.

About notifications

What an @mention sends, where it shows up, and what you can and can't change.

How to assign a persona to a card

Another card details panel section: tag a card with one or more personas.

How to bulk edit cards

Apply tags, personas, or formatting across many cards at once.

PreviousShape cards
NextLanes and columns

Last updated