How to use the Gherkin BDD Feature File Generator
- 1. Describe the featureAdd the feature name, user story and tags.
- 2. Write the stepsEnter Given, When and Then lines; use <placeholders> for data.
- 3. Add examplesPaste a CSV table to make a Scenario Outline, then download.
Gherkin structure
Gherkin is the plain-language format used by Cucumber, SpecFlow and Behave. A file starts with Feature:, often followed by a user story (As a… I want… So that…). A Background holds steps shared by every scenario. Each Scenario uses Given for context, When for the action and Then for the outcome, with And for extra lines.
With the defaults, the tool writes Feature: User login with the @login @smoke tags and a Scenario Outline: Log in with valid credentials. The steps contain <email>, <password> and <name>, and the Examples table supplies two rows, so the runner executes the scenario twice with different data.
Writing good scenarios
- Describe behaviour, not clicks: "When the user logs in" ages better than "When I click #btn-12".
- One behaviour per scenario, with a single When where possible.
- Keep Then observable: something the user or system can see.
- Use Outline + Examples for the same flow with different data, rather than copying scenarios.
The generator checks that every <placeholder> has a column in Examples, aligns the table, and turns extra Given/When/Then words you typed into a single clean keyword. It does not write step definitions; those are the code (Java, C#, Python or JavaScript) that your team links to each step. Turn scenarios into manual checks with the test case template generator.
Frequently asked questions
Can I add more than one scenario?
Generate each scenario and paste them under the same Feature line. Keep one Feature per file.
Do I need the user story?
No, it is optional, but it reminds everyone why the feature exists.
Is the Gherkin BDD Feature File Generator free?
Yes, the Gherkin BDD Feature File Generator is free. The first time you generate your first feature file, you are asked for your name and WhatsApp number once. After that, this and every other Uncodemy tool opens straight away without the form.