> For the complete documentation index, see [llms.txt](https://docs.does.qa/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.does.qa/values/built-in-values.md). # Built-in Values 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](/values/value-store.md). 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. | <93843@testcase.v2.doesqa.email> | | **testEmailShort** | The same Test Case inbox with a shorter address. | <93843@t.v2.doesqa.email> | | **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. | | | **accountEmailShort** | The same Account inbox with a shorter address. | | | **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. | | | **currentOrigin** | Origin of the current URL when this Value is used. | | | **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 `firstname.lastname@mock.does.qa`. | | | **randomShortEmail** | A short random email at `@mock.does.qa`. | | | **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 |