Skip to main content

Jira

Connect QA Hub to Jira Cloud to search stories, epics, and tasks directly from the Dashboard. Acceptance criteria are pulled automatically and used as context for AI test generation.

Prerequisites​

  • A Jira Cloud account with API access
  • A Jira API token (not your password)
  • Your Jira Cloud base URL (e.g., https://your-org.atlassian.net)

Generate a Jira API token​

  1. Log in to id.atlassian.com → Security → API tokens.
  2. Click Create API token, give it a label (e.g., "QA Hub").
  3. Copy the token — it is shown only once.

Configure in QA Hub​

  1. Go to Settings → Integrations.
  2. Select Jira as your connector.
  3. Fill in:
    • Base URL — your Jira Cloud URL (e.g., https://acme.atlassian.net)
    • Email — the Atlassian account email the token belongs to
    • API Token — the token you generated above
    • Project key (optional) — pre-filter results to a specific Jira project
  4. Click Test connection. A green indicator confirms success.
  5. Click Save.

Settings → Integrations — Jira form with Base URL, Email, API Token fields and the Test connection green indicator

Scrum team filtering​

If your team uses a custom Jira field to tag stories by scrum team, configure the field name in Settings → Integrations → Scrum team field. The Dashboard will show a team dropdown after tickets are fetched.

Searching tickets​

Once Jira is active, the Dashboard search uses JQL under the hood:

  • Keyword search → text ~ "your query" AND project = KEY
  • Load by ID → key IN (PROJ-42, PROJ-43)

Results include the issue title, description, acceptance criteria (from the configured custom field or description), status, priority, and epic key.

Confluence integration​

Connecting Jira also enables the Confluence tab in the Dashboard. See Confluence →.

Switching connectors​

The active connector is stored per-browser in localStorage. To switch to Linear or Azure DevOps, click the connector selector in the top bar. Your Jira credentials remain saved in Settings.