Built-in Values

A number of useful Values are provided at run time.

Built-in Values are available during a Run. Insert them with $ in supported fields, such as $testEmail or $randomNumber.

Account Values and overwrites interact with built-ins as described on Value Store. Reserved names such as testEmail keep their built-in meaning for the Test Case.

Test Specific Values

Test specific values are different across tests & runs but remain the same throughout a test run.

Name	Description	Example
testStartedAt	When the Test Case started, in the format YYYYMMDDHHmm.	202405201301
testStartedAtUnix	When the Test Case started, as a Unix timestamp in seconds.	1548381600
testStartedAtDay	Day the Test Case started, format DD.	12
testStartedAtMonth	Month the Test Case started, format MM.	05
testStartedAtYear	Year the Test Case started, format YYYY.	2024
testStartedAtDayOfWeek	Weekday the Test Case started, format ddd (for example Mon).	Mon
testStartedAtMonthText	Month the Test Case started as text, format MMM (for example May).	May
testName	Name of the Test Case. Built from Name Test steps when present, otherwise the Flow name with an index.	Login -> Register -> Verify Email
testNumber	Unique ID for this Test Case Run.	854987
testSentence	A generated sentence for this Test Case. Same value for the whole Test Case.	Voluptatum cupiditate suscipit autem eveniet aut dolorem aut officiis distinctio.
testFullName	A generated full name for this Test Case. Same value for the whole Test Case. Not the same as joining $testFirstName and $testLastName.	Bruce Wayne
testFirstName	A generated first name for this Test Case. Same value for the whole Test Case.	Peter
testLastName	A generated last name for this Test Case. Same value for the whole Test Case.	Parker
testEmail	A unique address for each Test Case. Use it with Mail Test Steps to wait for and open messages in the Test Case inbox.	[e-mail]
testEmailShort	The same Test Case inbox with a shorter address.	[e-mail]
testUsername	A generated username for this Test Case. Same value for the whole Test Case.	tony.stark
testZipCode	A generated US ZIP code in the format #####.	10145
testPhoneUS	A generated US phone number in the format (###) ###-###.	(123) 456-789
testPhoneUK	A generated UK phone number in the format ##### ### ###.	01190 123 456

Run Specific Values

Run specific values are different across runs but the same within all tests in a run.

Name	Description	Example
runId	Run ID shared by every Test Case started under the same command (Flow, Schedule, or CI/CD).	k7Qm2Nx
runLabel	Label set when the Run started (for example from CI/CD). If none was set, the value is No label set.	Staging Deploy v1.1

Account & Flow Values

Values unique to your account or the Flow the Test Case is from. These stay the same across Runs.

Name	Description	Example
accountEmail	A shared mailbox for your account. Prefer $testEmail for registration and other one-test journeys. Use $accountEmail when several Test Cases should share one inbox.	[e-mail]
accountEmailShort	The same Account inbox with a shorter address.	[e-mail]
flowName	Name of the Flow this Test Case came from.	Users & My Account

Date Values

Name	Description	Example
currentUnix	Timestamp at the moment this Value is used.	1716209461000
currentISO	Current time as an ISO 8601 string when this Value is used.	2024-05-20T13:01:01.000Z
nextDay	Day one day after the Test Case started, format DD.	13
nextMonth	Month one month after the Test Case started, format MM.	06
nextYear	Year one year after the Test Case started, format YYYY.	2025
yesterdayDay	Day one day before the Test Case started, format DD.	11
yesterdayMonth	Month of the day before the Test Case started, format MM.	05
yesterdayYear	Year of the day before the Test Case started, format YYYY.	2024
tomorrowDay	Day one day after the Test Case started, format DD.	13
tomorrowMonth	Month of the day after the Test Case started, format MM.	05
tomorrowYear	Year of the day after the Test Case started, format YYYY.	2024

$nextDay and $tomorrowDay both mean the calendar day after start. $nextMonth advances by one month. $nextYear advances by one year.

URL Values

Name	Description	Example
currentUrl	Full URL when this Value is used.	https://does.qa/test-automation/variable-values
currentOrigin	Origin of the current URL when this Value is used.	https://does.qa
currentPath	Path of the current URL when this Value is used.	/test-automation/variable-values

Random Values

These Values produce a new result each time they are used.

Name	Description	Example
randomNumber	A random number between 1 and 99999.	12345
randomSentence	A random sentence.	Voluptatum cupiditate suscipit autem eveniet aut dolorem aut officiis distinctio.
randomFullName	A random full name.	Wanda Maximoff
randomFirstName	A random first name.	Henry
randomLastName	A random last name.	Osborn
randomUsername	A random username.	happy.hogan
randomEmail	A random email in the format [e-mail].	[e-mail]
randomShortEmail	A short random email at @mock.does.qa.	[e-mail]
randomPhoneUK	A random UK phone number in the format ##### ### ###.	01190 123 456
randomPhoneUS	A random US phone number in the format (###) ###-###.	(123) 456-789
randomZipCode	A random US ZIP code.	45874