Step Variables Overview

Step variables are a simple way to inject dynamic data into your tests. Learn about the variable types we support here!


Step variables (our generic term for all variables we support) are a simple way to inject dynamic data into your tests. When added, the variable acts as a placeholder; when a tester executes your test, they will see the value that corresponds to the variable you’ve inserted. 

Rainforest supports 7 types of step variables. Read on for a brief overview of each variable type. Click into each variable name to learn more about that specific type of variable, including short set-up videos and example use cases:

  • Custom Variables: Custom variables allow you to share single values across multiple steps and tests. This is useful for information like a test credit card number,  URL, or any other single value that is reused in many tests or frequently changes. Rather than typing the value over and over again in every test, you simply create a custom variable and then reuse it across your tests and steps. When you need to change the value that corresponds to the variable, you can do so quickly and simply, and the value updates across all tests that contain the custom variable. 

  • Tabular Variables: Tabular variables allow you to define your own variables in a CSV file and upload them to Rainforest. This allows you to assign each tester unique values that you yourself define. The most common use-case for tabular variables is assigning unique login credentials to each tester, so that testers can execute your tests in parallel in separate test accounts. 

  • Conditional / Environmental Variables: Take tabular variables a step further by creating environment-specific variables. If you require different login credentials per environment, this is the variable for you!

  • Built-in Variables : Built in to Rainforest, these variables generate random and discrete data, such as random first name, random email, random inbox, or random social security number. 

  • Social Variables: Social variables automatically trigger the generation of test Facebook accounts upon run initiation.

  • SMS Variables: Use Rainforest’s pool of SMS numbers to test your app's ability to send text messages, then use our SMS inbox variable to verify receipt of the SMS, all from within the web browser. No mobile device needed! If you'd like to purchase your own pool of dedicated SMS numbers, check out our Private SMS offering. 

  • Virtual Credit Cards: Test real payments in production using Rainforest's Virtual Credit Card (VCC). Rainforest’s VCCs are real credit cards that represent real credits and generate real monetary transactions. They can be used any place where major credit cards are accepted. Note: VCC is a feature add-on. Please contact us to ask about an upgrade.

How to use your variables in your test cases

Visit one of the articles listed above to find out how to add and manage the variable type(s) that you need.

Insert Step Variables into a Rainforest Test

  1. At the individual action, if step variables are appropriate for use, the option will appear once the value box is selected.
  2. Click on { } Step Variables to expand the selection.
  3. Select the variable category to expand available variables.
  4. Select the individual variable to use.
    Note: The placeholder {{}} will be replaced with the actual value whenever the test is run.

Insert Step Variables into a Rainforest Classic test

  1. Within the step editor in a test, click {} step variables to bring up the step variables menu. The variables shown will be grouped by type (e.g. custom variable, tabular variable, etc):
  1. Click on any of the step variable groups to reveal all the step variables within it:
  1. Finally, click the variable you wish to insert.

The placeholder e.g. {{}} will be replaced with the actual value whenever the testers see it in the test. Want to see for yourself? Go ahead and Preview your test by following the steps in the Gif below!

If you have any questions, please feel free to reach out to us at [email protected] or through Intercom!

Updated 2 months ago

Step Variables Overview

Step variables are a simple way to inject dynamic data into your tests. Learn about the variable types we support here!

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.