Scenario outline
A scenario outline is a Gherkin construct that defines a parameterized scenario expanded into multiple executions using values from an examples table.
Effective Behavior-Driven Development
A Gherkin construct that defines a parameterized scenario expanded into multiple examples.
- How it is used
- Condenses similar scenarios while preserving readable differences in data or wording.
- How deep it goes
- Explains templates, placeholder matching, row expansion, and unused columns without detailing automation internals.
- Examples
- Uses pizza calculations, contact-detail validation, and authenticated versus unauthenticated order collection.
- What you can do after
- Evaluate whether an outline clarifies repeated scenarios or whether separate scenarios are easier to read.
Read how Effective Behavior-Driven Development explains scenario outline →
BDD in Action, Second Edition
A scenario outline is a Gherkin construct that defines a parameterized scenario whose placeholders are replaced with values from an examples table for repeated execution.
- How it is used
- Uses parameterized scenarios to communicate and automate related business-rule cases without duplicating nearly identical scenarios.
- How deep it goes
- Explains placeholders, Examples rows, repeated execution, and edge-case exploration, but does not detail step-definition implementation.
- Examples
- Uses flight-eligibility cases and cash-and-points payment combinations to demonstrate repeated execution across data rows.
- What you can do after
- Apply via Cucumber by writing placeholders, supplying Examples rows, and checking precise outcomes for each case.
Read how BDD in Action, Second Edition explains scenario outline →
What to know first
- business ruleA business rule is a domain-specific constraint, policy, or decision criterion that governs valid data, behavior, decisions, or processes.
- scenarioA scenario is a specified or described situation, sequence of events, or set of conditions used to represent or examine behavior, processes, or possible outcomes.
- GherkinGherkin is a structured, human-readable domain-specific language for expressing software behavior as features and scenarios with steps such as Given, When, and Then.
Related concepts
- examples tablehas part · An examples table is a Gherkin table whose rows supply values for generating scenario executions from a scenario outline.
- placeholderhas part · A placeholder is a temporary or symbolic stand-in for a value, content, object, or functionality in a designated position or role.
- scenario automation toolused by · A software tool that converts behavioral scenarios into executable tests by invoking automation code for their steps.
- scenarioalternative to · A scenario is a specified or described situation, sequence of events, or set of conditions used to represent or examine behavior, processes, or possible outcomes.
- parameterized executionalternative to · A pattern in which automation code uses test parameters to vary execution choices and extend scenario coverage.
- example mapuses · An example map is a visual arrangement of examples, rules, counterexamples, and related questions for exploring how a software feature should behave.
Questions about scenario outline
What is scenario outline?
A scenario outline is a Gherkin construct that defines a parameterized scenario expanded into multiple executions using values from an examples table.
Which Manning books explain scenario outline?
Effective Behavior-Driven Development and BDD in Action, Second Edition.
What should I know before learning scenario outline?
Manning books that teach scenario outline usually introduce business rule, scenario, examples keyword and Gherkin first.
What is the difference between scenario outline and scenario?
A scenario outline is a Gherkin construct that defines a parameterized scenario expanded into multiple executions using values from an examples table. A scenario is a specified or described situation, sequence of events, or set of conditions used to represent or examine behavior, processes, or possible outcomes.
What are the parts of scenario outline?
Scenario outline includes examples table and placeholder.
These guides are generated from the text of Manning books by Manning's knowledge graph and link to the sections they draw on. The full books are available on liveBook and at manning.com.

