Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


A Gwen interpreter that enables teams to automate front end web tests and repetitive online processes with Gherkin feature specifications. A web engine interacts with Selenium under the covers to perform operations and checks in browsers. All the standard Selenium locators are supported and you can additionally inject JavaScript in places where dynamically finding elements or running functions on web pages may be necessary.

Get Started

Visit the Gwen home page for our user documentation and getting started guide.

Current Status


How it Works?

  1. Declare feature specs to describe scenarios in the language of your domain.
  Feature: Todo

 Scenario: Create todo list
     Given a new todo list
      When the following items are added
           | Get the milk  |
           | Walk the dog  |
      Then the list will contain 2 items
  1. Compose meta specs to describe how steps will execute to automate scenarios.
  Feature: Todo Meta (automation glue)
 Scenario: a new todo list
      When I navigate to ""
      Then the todo field can be located by class "new-todo"
       And count can be located by css ".todo-count strong"

 Scenario: the following items are added
      When I enter item in the todo field
      Then count should be record.number

 Scenario: the list will contain <expected> items
      Then count should be "$<expected>"
  1. Launch Gwen to bind your meta and execute your feature specs to automate.

System Requirements

  • Linux, Mac or Windows OS
  • Chrome, Firefox, Safari, Edge or IE web browser
  • Java 8 (version 1.8) or higher


Copyright 2014-2022 Brady Wood, Branko Juric and Gwen contributors.

This software is open sourced under the Apache License, Version 2.0.

See also: LICENSE.

This project has dependencies on the core Gwen interpreter and other open source projects. All distributed third party dependencies and their licenses are listed in the LICENSE-THIRDPARTY file.

Open sourced 28 June 2014 03:27 pm AEST


New capabilities, improvements, fixes, and documentation are all welcomed candidates for contribution. Each submission is reviewed and verified by the project maintainers before being integrated and released to the community. We ask that all code submissions include unit tests or sample test features providing relevant coverage.

By submitting contributions, you agree to release your work under the license that covers this software.

How to Contribute

  1. Fork this repository
  2. Create a branch on your forked repository
  3. Commit your changes to your branch
  4. Push your branch to your forked repository
  5. Create a pull request from your branch to here



We thank the following contributors and active users for helping to make Gwen better.

The following contributors submitted pull requests that have been merged:

The following users raised issues or requests that have been addressed: