Skip to content


If you are new to the project or Behat, we recommend that you first read through our documentation. For any questions, feedback, or to contribute, you can get in contact with us via Github or our Slack.


  • If you are using Selenium to run Javascript tests, and you access your WordPress site over HTTPS, and your site has a self-signed certificate, you will need to manually configure the web browser to accept that certificate.


  • If you are using the WP-CLI driver to connect to a remote WordPress site over SSH, WordHat assumes the remote server is Linux-like, with a shell that provides GNU Coreutils.
  • To configure WordHat to use a specific driver, set default_driver in your behat.yml.
  • As of v1.1.0, it is possible to use multiple drivers at the same time. This should be considered an experimental feature for advanced users only. To enable it, tag a scenario with the name of the driver to use (e.g. @wpcli or @wpphp).


Supported platforms

  • WordHat supports MacOS, most flavours of Linux, and Windows. We use Travis-CI to test on Ubuntu, and require modern versions of PHP.

Virtual machines (Vagrant)

  • If you are using a Vagrant-powered virtual machine to run Behat via the WP-CLI driver, you will need to vagrant ssh into the box once. This will set up password-less authentication; otherwise, WordHat will prompt you for the SSH password frequently.


  • If your WordPress is installed in a subdirectory, you need to set the site_url option to the value of the “WordPress address (URL)” option (found in WordPress > Settings > General). For more information, consult the WordHat documentation.