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)
- Match. Emails align on both sides → a real ping with a clickable link to the right person on the destination side.
- Display-name fallback. The email aligns on one side but not
the other → the mention renders as
@DisplayNameplain text — no ping, but readable. - Literal fallback. The raw ID (
@U12345in Jira or@accountidin 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@DisplayNametier, 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?