Jira

Issue trackers

Publish approved user stories straight into Jira Cloud

When user stories are written from memory after the meeting, some come out wrong and some never get written. Spectr drafts them from the meeting itself. Connect a Jira Cloud site, pick the project they land in, and every story you approve becomes a real Jira issue with its description, acceptance criteria, type, priority, labels, estimate and assignee already set. A status refresh then reads each issue's status back, so what Spectr thinks has shipped matches what actually has.

How Jira fits in

Import your call. Let Spectr take over.

A call is imported from a note-taker (Fathom, Granola, Read.ai, or Fireflies.ai). Spectr picks out a requirement, a bug, an action item and an out-of-scope ask, and drafts a story and a bug with acceptance criteria. A person approves both, they are published to Jira, and the requirements, scope log and project memory update from the same call.

How it connects

OAuth 2.0 (3LO). You pick the Jira site on Atlassian's own consent screen. Spectr requests read and write access to Jira work plus read access to users, and refreshes the token itself.

Before you start

A Jira Cloud site - Server and Data Center are not supported. New issues go to the one Jira project you pick for each Spectr project.

What Spectr reads from Jira

Projects, issue types and statuses
Read once at setup so you can choose where issues land and, optionally, which issue type and starting status they use. Statuses are workflow-scoped, so changing the project or issue type clears the dependent choice rather than leaving a stale one.
Completion status of published issues
A batched JQL read maps each issue's status category onto the story in Spectr. A story is only "done" when every tracker it was published to says so, and that feeds the budget projection. An issue deleted in Jira is skipped rather than overwriting what Spectr already knows.
Assignable users
The selected project's assignable-user list syncs into the project team, so a story's assignee can be a real person rather than a name typed twice.

What Spectr writes to Jira

Descriptions in Jira wiki markup
Descriptions and acceptance criteria are converted from markdown to Jira wiki markup on the way in, so headings and lists render as headings and lists instead of raw syntax.
Type, priority, labels and estimates
Feature maps to Story, bug to Bug, chore and spike to Task - resolved against the project's real issue types. Priority maps by name against your instance's own priority scheme. Labels are slugified because Jira rejects spaces in them. Estimates use your site's story-points field when it exists.
Parent and sub-task nesting
When a spec-sheet task is marked as a parent, Spectr creates a parent issue for it and nests its stories beneath as real Jira sub-tasks, unless sub-tasks are switched off for the project. If the project has no sub-task type, it publishes flat rather than failing.

Setting it up

  1. In Spectr, open the project and go to Integrations.

  2. Choose Jira and click Connect. Atlassian asks which site to authorise.

  3. Pick the Jira project new issues should land in.

  4. Optionally set Story defaults - a default issue type and the status new issues should start in.

  5. Generate stories from a meeting, review them, and publish. Each story in Spectr then links to the Jira issue it became.

Frequently asked questions

Anything else? Email hello@crowdlinker.com and a person will answer.

Which Jira fields does Spectr fill in?

Summary, a description carrying the acceptance criteria, issue type, priority, labels, assignee, and the estimate in your story-points field when the site has one.

Does Spectr support Jira Server or Data Center?

No. The integration is Jira Cloud only, over Atlassian's OAuth 2.0 (3LO) flow.

Why do my labels come back with hyphens?

Jira rejects labels containing spaces, so "Auth Flow" is published as "Auth-Flow". Spectr deliberately does not sync labels back from Jira, because un-slugifying them would guess at your data and sometimes guess wrong.

What happens to a story if someone moves or renames the issue in Jira?

Spectr stores Jira's stable numeric id alongside the human key, so a rename or a project move does not break the link. The key and browse URL are backfilled on the next status refresh.

Related

Use case

Write user stories your developers can actually start

Draft stories with real acceptance criteria, then approve, edit or reject each one

See all 20 integrations →

AI ProductOps for the entire team.

Start for free at spectr.pm
  • Free plan
  • No credit card to sign up
  • 30-day free trial on Starter