Built-In Data

Learn how to generate random data for standard fields such as name, address, and email.

Use built-in data anywhere in your test steps to automatically generate discrete values for testers to enter. For example, in a signup test, you could provide first names, last names, and email addresses.

Note: Variables are now called test datatest data - Placeholders that allow you to inject other values into your tests. Rainforest supports three types: dynamic, static, and built-in..

Adding Built-In Test Data to a Test Step

  1. In the step editor, click Insert Test Data to display the test data menu.
Adding built-in test data to a test step.Adding built-in test data to a test step.

Adding built-in test data to a test step.

  1. In the pop-up, click any of the built-in data groups to reveal the placeholders.
Placeholders for the built-in data group.Placeholders for the built-in data group.

Placeholders for the built-in data group.

  1. Select the placeholder you want to use. Then, click the Save button.

Built-In Data Types

Rainforest breaks out the built-in data types into three groups:

  • Date Time - populates the date and time when the test starts.
  • Rainforest - populates Rainforest environmental information when the test executes.
  • Random - populates randomly generated contact and location information when the test executes.

Date Time

Data Type
Description
date_time.now
Populates date and time of the start of the run in “yyyy-mm-ddThh:mm:ss+Timezone change” such as “2022-03-29T15:11:30+00:00” for March 29, 2022 at 3:11pm and 30 seconds in UTC.
date_time.mm_dd_yyyy
Populates date at the start of the run in “mm/dd/yyy” format such as “03/29/2022”
date_time.yyyymmdd
Populates date of the start of the run in “yyyymmdd” format such as “20220329”
date_time.hhmm
Populates time at the start of the run in “hhmm” format such as “1511” for 3:11pm.
Note: Uses 24 hour clock and based on UTC.
date_time.hhmmss
Populates time at the start of the run in “hhmmss” format such as “151130” for 3:11pm and 30 seconds.
Note: Uses 24 hour clock and based on UTC.
date_time.week_ago_yyyymmdd
Populates date of one week ago in “yyymmdd” format such as “20220322” if today is March 29, 2022.
date_time.tomorrow_yyyymmdd
Populates tomorrow’s date in “yyymmdd” format such as “20220330” if today is March 29, 2022.
date_time.a_week_today_yyyymmdd
Populates date of one week in the future in “yyymmdd” format such as “20220405” if today is March 29, 2022.
date_time.a_month_today_yyyymmdd
Populates date of one month in the future in “yyymmdd” format such as “20220429” if today is March 29, 2022.
Rainforest Date Time data types.

Rainforest

Data Type
Description
rainforest.url_base
Populates with the base start URL of the test.
rainforest.environment_id
Populates with the Rainforest enviornment id.
rainforest.test_id
Populates with the Rainforest test id.
Rainforest Data Types.

Random

Data Type
Description
random.email
A unique character string ending in the domain @e.rainforestqa.com.
random.inbox
A static URL paired with random.email in the format rainforestqa.com/{{unique character string}}. See Notes on the random.inbox Placeholder.
  • e.rainforestqa.com/aff9a400-3939-433f-a065-239514a9ee25
random.first_name
The person’s first name, such as Korbin.
random.last_name
The person’s last name, such as Cartwright.
random.full_name
The person’s full name, such as Korbin Cartwright.
random.password
An 8-character combination of lowercase letters and capital letters, such as yGehSMZt.
random.image
A URL to an image hosted on AWS S3. See Notes on the random.image Placeholder.
  • https://s3.eu-central-1.amazonaws.com/rainforest-random-images/001.jpeg
random.number
A numerical value in the range of 1 to 1,000,000,000, such as 848598698.
random.phone_number
A 12-character value that includes an area code, number, and hyphens, such as 415-555-1212.
random.address_line1
The first line of the address, such as 123 Main St.
random.address_line2
The second line of the address, such as Apt. 992.
random.address_city
The name of the city, such as San Francisco.
random.address_state
The name of the state, such as California.
random.address_zip
A 10-character value that includes the ZIP+ 4 Code and a hyphen, such as 94104-0231.
random.address_zip5
A 5-digit ZIP Code, such as 94104.
random.address_country
The name of the country, such as United States.
random.ssn
An 11-character fake Social Security Number consisting of 9 digits and 2 hyphens, such as 306-18-8104.
random.company
The company name, such as Schoen, LLC.
Random Data Types.

Note: The following data types apply only to the United States:

  • random.phone_number
  • random.address_state
  • random.address_zip
  • random.address_zip5
  • random.ssn

Notes on the random.inbox Placeholder
In each test, a tester is assigned a {{random.inbox}} paired with a {{random.email}}. Though you can use these placeholders individually, we recommend using them together to create an effective test.

Notes on the random.image Placeholder
When using random.image, you can ask testers to save or copy the image to test upload functionality. The image is a hosted file. When the link is opened, it appears in a new tab.

📘

Sample Download Instructions

Action: In a new tab, open {{random.image}}. Right-click the image and select “Save As.” Then, click the Save button in the modal.

Question: Was the image downloaded and saved successfully?

For information on other test data types you can use, see Using Test Data.


If you have any questions, reach out to us at [email protected].


Related Articles & Links
Did this page help you?