Skip to main content
Dynamic variables are built in values that are generated automatically at request execution time. They remove the need for manual inputs or custom scripts when you need commonly used data like timestamps, random values, or unique identifiers. Unlike environment, collection, or global variables which you define yourself, dynamic variables are available out of the box and always generate a fresh value when a request runs.
Requestly uses Faker.js to generate realistic data for dynamic variables.
They are accessed using the special $ prefix syntax:

Using dynamic variables

You can use dynamic variables anywhere in a request including the URL, headers, query params, and body.
Use dynamic variables like {{$randomFirstName}}, {{$randomLastName}}, and {{$randomEmail}} to create unique user data for each request:
Script syntax: When using dynamic variables in scripts, call them as functions: rq.$variableName() instead of the template syntax {{$variableName}}.

Variable precedence

When the same variable name is defined as both a dynamic variable and a user-defined variable (environment, collection, or global), the user-defined variable takes precedence.

Precedence order

User-defined variables (Runtime → Environment → SubCollection → Collection → Global) > Dynamic variables Example : If you define an environment variable named $randomUUID:
And then use {{$randomUUID}} in your request, it will resolve to "123e4567-e89b-12d3-a456-426614174000" (your custom value), not the dynamic UUID value.
Best practice: Never use the $ prefix (e.g., {{$randomUUID}}) for user-defined variables.

Use arguments with dynamic variables

Some dynamic variables support optional arguments to customize their output.
For a complete list of variables that support arguments and their available options, see the Variables with arguments section below.

Syntax

Example:
Script syntax: When using dynamic variables in scripts, call them as functions: rq.$variableName(arg1,arg2 ...)

Supported dynamic variables

Requestly provides a comprehensive set of built-in dynamic variables organized by category.

Common

Text, Numbers and Colors

Internet and IP Addresses

Names

Profession

Phone, Address and Location

Images

Finance

Business

Catchphrases

Databases

Dates

Domains, Emails and Usernames

Files and Directories

Stores

Grammar

Lorem Ipsum

Variables with arguments

The following dynamic variables support optional arguments for customization.

Common

Arguments: version (4|7), refDate
Arguments: version (4|7), refDate

Text, Numbers and Colors

Arguments: length | (min max), casing (upper|lower|mixed), exclude
Arguments: probability (0-1)
Arguments: max | (min max)
Arguments: format (hex|css|binary), includeAlpha (true|false), prefix, casing (upper|lower|mixed)

Internet and IP Addresses

Arguments: cidrBlock | network
Arguments: separator
Arguments: length, memorable (true|false), pattern, prefix

Names

Arguments: gender (male|female)
Arguments: gender (male|female)
Arguments: gender (male|female)
Arguments: gender (male|female)

Phone, Address and Location

Arguments: style (human|national|international)
Arguments: useFullAddress (true|false)
Arguments: variant (alpha-2|alpha-3|numeric)
Arguments: max | (min max), precision
Arguments: max | (min max), precision

Images

Arguments: width, height
Arguments: width, height, color, type (svg-uri|svg-base64)

Finance

Arguments: length (default 8)
Arguments: issuer
Arguments: includeBranchCode (true|false)
Arguments: formatted (true|false), countryCode
Arguments: type (legacy|segwit|bech32), network (mainnet|testnet)

Dates

Arguments: years, refDate
Arguments: years, refDate
Arguments: days, refDate
Arguments: abbreviated (true|false), context (true|false)
Arguments: abbreviated (true|false), context (true|false)

Domains, Emails and Usernames

Arguments: firstName, lastName, provider, allowSpecialCharacters (true|false)
Arguments: firstName, lastName, allowSpecialCharacters (true|false)
Arguments: firstName, lastName
Arguments: protocol (http|https), appendSlash (true|false)

Files and Directories

Arguments: extensionCount | (min max)
Arguments: mimeType

Stores

Arguments: max | (min max), dec, symbol

Grammar

Arguments: length | (min max), strategy (fail|closest|shortest|longest|any-length)
Arguments: length | (min max), strategy (fail|closest|shortest|longest|any-length)
Arguments: length | (min max), strategy (fail|closest|shortest|longest|any-length)
Arguments: length | (min max), strategy (fail|closest|shortest|longest|any-length)
Arguments: count | (min max)

Lorem Ipsum

Arguments: length | (min max), strategy (fail|closest|shortest|longest|any-length)
Arguments: count | (min max)
Arguments: wordCount | (min max)
Arguments: count | (min max), separator
Arguments: sentenceCount | (min max)
Arguments: count | (min max), separator
Arguments: count | (min max)
Arguments: count | (min max)

What’s Next?

Environment Variables

Store and manage auth tokens securely with variables

Runtime Variables

Use temporary variables for request execution