BA Prince the B.A. Subscribe

Home / Jira & Confluence for BAs

Comments and Mentions in Jira (Get Answers Faster)

Comments and Mentions in Jira (Get Answers Faster)

Watch on YouTube Subscribe

Ask your question on the Jira work item itself: open the comment box, at mention the person who knows, and ask one clear question with a reason. The answer stays with the story, not in someone's inbox.

Step by step

Why comment

  1. Comments and mentions. An emailed question is easy to lose, and the rest of the team never sees the answer. In Jira, ask it as a comment on the work item and mention the person who knows.

The story

  1. Create a story. The example: a shop is adding gift cards, and the BA has a question for the product owner. First, create the story. Click Create. Click the work type field, and pick Story, the one with the green bookmark icon. Type the summary: Pay with a gift card. Click Create to save the story.
  2. Open it. The new story appears at the bottom of the backlog. Click it and it opens in a panel on the right.

Ask the question

  1. The comment box. The comment box is under Activity. Everyone who opens this story can read what you write here. Shortcut: with the work item open, press M and the comment box opens, ready for typing.
  2. Mention the person. Start with the person. Type @ and the first letters of their name, here @Pri. Jira shows a list of people who match. Click the right person from the list. On a real team, that's the product owner. The name turns into a blue mention, so you know Jira has linked it to that person.
  3. One clear question. After the mention, ask one clear question and say why you need the answer: can a gift card be used with a discount code? We need this for the checkout rules. Click Save. The comment is posted on the story.
  4. They get told. The comment now sits on the story with the blue mention. Jira notifies the mentioned person, with a link straight back to this work item.

Recap

  1. Ask on the work item. In short: open the work item and press M, type @ and pick the person, then ask one clear question with a reason. The answer stays on the story, where the whole team can find it later.

Common mistakes

  • Typing the name but not picking it from the list. If you type @Prince and keep typing, it stays plain text and nobody is notified. Click the name in the list so it turns into a blue mention.
  • Asking several questions in one comment. People tend to answer the first question and skip the rest. Ask one clear question and add the reason, like the gift card and discount code example.
  • Pressing M while typing in another field. Keyboard shortcuts don't work while your cursor is in a text field, so M just types the letter. Click outside the field first, or click the comment box under Activity.
  • Mentioning someone who can't see the project. If the person doesn't have access to the project, they can't open the work item, even after a mention. Ask your Jira admin to give them access, or ask someone who already has it.

When a business analyst uses this

In backlog refinement, a BA finds an open business rule on a story, like whether gift cards work with discount codes. They mention the product owner in a comment on that story, so the answer stays with the story for developers and testers, instead of getting lost in an inbox before sign-off.

Questions people ask

How do I mention someone in a Jira comment?

In the comment box, type @ and the start of the person's name, then click them in the list. Their name turns into a blue mention, which shows it worked.

Does Jira notify people when you mention them in a comment?

Yes. Jira sends the person a notification with a link to the work item. Whether they also get an email depends on their notification settings.

What is the keyboard shortcut to add a comment in Jira?

Press M while the work item is open, and the comment box opens ready for typing. It won't work if your cursor is already in a text field.

More in Jira & Confluence for BAs