Gatling Options

Gatling scenarios have various options available. This document describes each option in detail.


General Settings

Includes the basic setup to define your scenario:

  • Source: Either upload all files to Testable or choose to link with a Git repository. If you link to a repository the contents will be cloned onto the test runner when the test starts.
  • Concurrent Users: Number of users each Gatling instance will simulate. Your simulation can access this value as the users system property (Integer.getInteger("users")). While your Gatling scenario is not forced to use this system property, it is highly encouraged so that the test can be distributed appropriately across the test runner infrastructure.
  • Gatling Version: Which version of the Gatling binary to use. Currently versions 3.0.2, 2.3, and 2.2.4 is supported. Please contact us to request other version added.
  • Simulation Name: If multiple simulations are uploaded, specify the main one here. Only required if multiple simulations are uploaded or contained your repository.
  • Repository: If you chose to link the scenario to a repository, select the repository here.
  • Branch: Which branch or tag to use when cloning the repository. Only available if Source = Repository.


  • Simulations Directory: Directory within the linked repository or uploaded files that contains the simulations. Note that any simulations in the root directory will be automatically copied to this directory. If you are uploading files remember that you cannot directly create a directory but that any uploaded zip files will be unzipped on the test runner and preserve any directory structure. Defaults to user-files/simulations.
  • Bodies Directory: Directory containing any request bodies for the simulation. Defaults to user-files/bodies.
  • Data Directory: Directory containing any feeder data for the simulation. Defaults to user-files/data.
  • Additional Libs: Directory containing any additional jar files to include on the Gatling classpath.
  • Java Options: Any additional options to include when executing Gatling. This can include system properties, memory settings, etc.


Parameters are a way to specify values when defining your Test Configuration and then utilizing these within your scenario.

Parameters are passed to your Gatling simulation as system properties. For example to pass an Environment parameter to your scenario:

  1. Add an Environment parameter in the Params section of the scenario.
  2. Use this value within you code via the System.getProperty("Environment") syntax.
  3. When you create your Test Configuration it will ask you to specify a value for Environment. This value will then be passed down into your simulation as defined above.

Read more about scenario parameters here.