How @-mentions map between Jira and Slack

An @mention should reach a person, not a raw ID. Threadmaker maps an @mention across the boundary — Slack @user to Jira @user and back — whenever the two accounts share an email, and falls back gracefully to a readable name when they don't.

Add Threadmaker to Slack — free for up to 10 Jira users.

The three-tier fallback (no setup required)

  1. Match. Emails align on both sides → a real ping with a clickable link to the right person on the destination side.
  2. Display-name fallback. The email aligns on one side but not the other → the mention renders as @DisplayName plain text — no ping, but readable.
  3. Literal fallback. The raw ID (@U12345 in Jira or @accountid in Slack) shows only when the user lookup fails entirely — a deleted account or an API error — or, on the Slack→Jira side, for mentions past the 10-per-comment cap. A merely missing email still falls back to the readable @DisplayName tier, never straight to the raw ID.

Limits

User lookups are cached for 24 hours per workspace. Up to 10 distinct mentions resolve per comment — a Cloudflare subrequest cap; extras past ten render as the raw ID on the Slack→Jira side.

Privacy of the email match

The emails used for matching live only in Threadmaker's Cloudflare D1 database (encrypted at rest), isolated per workspace, refreshed about every 24 hours, deleted 30 days after the last refresh, and deleted immediately when the workspace uninstalls. They're never shared with third parties or used for profiling. See the Privacy Policy for the full PII boundary.

FAQ

Do I have to map users by hand? No — matching is automatic on shared email; there's no admin step and no mapping table to maintain.

What if someone's Slack and Jira emails differ? The mention falls back to a readable @DisplayName (no ping) — it never degrades to a raw ID just because an email is missing.

Why only ten mentions per comment? Cloudflare caps the number of subrequests per invocation; anything past ten renders as the raw ID on the Slack→Jira direction.

Related

Full reference in the setup guide. See also attachments, edits and deletes, and live status in the thread — or read the support-escalation playbook, where mentions carry the handoff. Back to all features.

Ready to try it?

Get started free Read the docs