Atlassian Connect end of support: 31 January 2027 · 74 days left
Gherkin Studio

Guides

Gherkin and BDD in Jira, in practice

Short guides for people who write scenarios in Jira and keep them in Git. Each one was checked against the app and the official Cucumber parser.

How to write Gherkin scenarios in a Jira story

Where the text lives, what the editor checks, and three typos that are valid Gherkin.

Gherkin syntax errors, explained in plain English

Every message the Cucumber parser gives, what it means and how to fix it.

Link Cucumber scenarios to Jira issues with tags

Where the @KEY-123 tag goes, and the forms that quietly do not work.

Keep .feature files in Jira and Git in sync

The three cases of a two-way sync, and the one that loses work.

Show Cucumber test results on Jira stories

Cucumber JSON from your pipeline to pass or fail on the story, with a GitHub Actions example.

AI-drafted Gherkin scenarios from a Jira story: what is sent, and how to review

What leaves Jira when you click AI draft, and a five-minute review routine.

How to choose a BDD app for Jira Cloud: nine questions

Nine questions you can check in a trial, and our own answers, including what we do not do.

Scenario Outline and Examples tables: what runs, and what quietly does not

How the rows are read, two errors, and four mistakes that give no error.

Data tables and doc strings in Gherkin: the rules nobody writes down

Cell counts, escapes, fences, and the missing pipe that drops a column.

Gherkin Background: when it helps, and when it hides the scenario

The parser's rules for Background, and a ten-second test for when it has grown too far.

Acceptance criteria and Given/When/Then in Jira: rules first, examples second

Why a criterion is not a scenario, and how the Rule keyword keeps them together.

Write Gherkin steps your team can reuse

Six habits, and how step suggestions keep a team on one wording.

The Cucumber JSON report: what is in the file, and which tools write it

An annotated file, the tools that write it, and how pass or fail is decided.

Send Cucumber results to Jira from GitLab CI, Bitbucket Pipelines and Jenkins

An example for each of three CI systems, and the failure that makes no noise.

Connect end of support: a checklist for BDD teams in Jira

Check what your BDD app runs on, and get your scenarios out safely.

Building a Gherkin editor and two-way Git sync on Atlassian Forge: eight things I learned

Forge storage and timeout limits, Git conflict codes, and the numbers we measured.