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:
{{$variableName}}

Using dynamic variables

In Templates

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:

In Scripts

You can also access dynamic variables in scripts using the rq.$variableName() method syntax:
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:
rq.environment.set("$randomUUID", "123e4567-e89b-12d3-a456-426614174000");
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.

Variable arguments

Some dynamic variables support optional arguments to customize their output.

Syntax

{{$variableName arg1 arg2 ...}}
Example:
{
  "id": "{{$randomAlphaNumeric 10}}",
  "email": "{{$randomEmail \"John\" \"Doe\"}}",
  "age": "{{$randomInt 18 65}}",
  "price": "{{$randomPrice 10 100 2 \"$\"}}"
}
For a complete list of variables that support arguments and their available options, see the Variables with arguments section below.

Supported dynamic variables

Requestly provides a comprehensive set of built-in dynamic variables organized by category. Variables marked with ✓ support custom arguments.

Common

VariableDescriptionExample
{{$guid}}uuid-v4 style guidf47ac10b-58cc-4372-a567-0e02b2c3d479
{{$timestamp}}Current UNIX timestamp in seconds1739404800
{{$isoTimestamp}}Current ISO timestamp at zero UTC2026-02-13T14:25:30.177Z
{{$randomUUID}}A random 36-character UUIDa3bb189e-8bf9-3888-9912-ace4e6543002

Text, Numbers and Colors

VariableDescriptionExample
{{$randomAlphaNumeric}}A random alpha-numeric charactert
{{$randomBoolean}}A random boolean valueFALSE
{{$randomInt}}A random integer between 0 and 10000472
{{$randomColor}}A random human readable colorblue
{{$randomHexColor}}A random hex value#2f8a45
{{$randomAbbreviation}}A random abbreviationHTTP

Internet and IP Addresses

VariableDescriptionExample
{{$randomIP}}A random IPv4 address192.168.45.233
{{$randomIPV6}}A random IPv6 address2001:0db8:85a3:0000:0000:8a2e:0370:7334
{{$randomMACAddress}}A random MAC addressaa:bb:cc:dd:ee:ff
{{$randomPassword}}A random 15-character alpha-numeric password8kP2mX9qL4nB5wV3
{{$randomLocale}}A random two-letter language code (ISO 639-1)fr
{{$randomUserAgent}}A random user agentMozilla/5.0 ...
{{$randomProtocol}}A random internet protocolhttps

Names

VariableDescriptionExample
{{$randomFirstName}}A random first nameSarah
{{$randomLastName}}A random last nameJohnson
{{$randomFullName}}A random first and last nameMichael Anderson
{{$randomNamePrefix}}A random name prefixMs.
{{$randomNameSuffix}}A random name suffixJr.

Profession

VariableDescriptionExample
{{$randomJobArea}}A random job areaSecurity
{{$randomJobDescriptor}}A random job descriptorChief
{{$randomJobTitle}}A random job titleSenior Data Analyst
{{$randomJobType}}A random job typeEngineer

Phone, Address and Location

VariableDescriptionExample
{{$randomPhoneNumber}}A random ten-digit phone number555-987-6543
{{$randomPhoneNumberExt}}A random phone number with extension555-456-7890 x321
{{$randomCity}}A random city nameRiverside
{{$randomStreetName}}A random street nameOak Avenue
{{$randomStreetAddress}}A random street address456 Elm Drive
{{$randomCountry}}A random countryCanada
{{$randomCountryCode}}A random two-letter country code (ISO 3166-1 alpha-2)US
{{$randomLatitude}}A random latitude coordinate-23.5475
{{$randomLongitude}}A random longitude coordinate151.2095

Images

VariableDescriptionExample
{{$randomAvatarImage}}A random avatar imagehttps://example.com/avatar/512x512
{{$randomImageUrl}}A URL of a random imagehttps://example.com/images/640/480
{{$randomAbstractImage}}A URL of a random abstract imagehttps://loremflickr.com/640/480/abstract
{{$randomAnimalsImage}}A URL of a random animal imagehttps://loremflickr.com/640/480/animals
{{$randomBusinessImage}}A URL of a random stock business imagehttps://loremflickr.com/640/480/business
{{$randomCatsImage}}A URL of a random cat imagehttps://loremflickr.com/640/480/cats
{{$randomCityImage}}A URL of a random city imagehttps://loremflickr.com/640/480/city
{{$randomFoodImage}}A URL of a random food imagehttps://loremflickr.com/640/480/food
{{$randomNightlifeImage}}A URL of a random nightlife imagehttps://loremflickr.com/640/480/nightlife
{{$randomFashionImage}}A URL of a random fashion imagehttps://loremflickr.com/640/480/fashion
{{$randomPeopleImage}}A URL of a random image of a personhttps://loremflickr.com/640/480/people
{{$randomNatureImage}}A URL of a random nature imagehttps://loremflickr.com/640/480/nature
{{$randomSportsImage}}A URL of a random sports imagehttps://loremflickr.com/640/480/sports
{{$randomTransportImage}}A URL of a random transportation imagehttps://loremflickr.com/640/480/transport
{{$randomImageDataUri}}A random image data URIdata:image/svg+xml;charset=UTF-8...

Finance

VariableDescriptionExample
{{$randomBankAccount}}A random 8-digit bank account number78945612
{{$randomBankAccountName}}A random bank account nameSavings Account
{{$randomCreditCardMask}}A random masked credit card number1234
{{$randomBankAccountBic}}A random BIC (Bank Identifier Code)DEUTDEFF
{{$randomBankAccountIban}}A random 15-31 character IBANGB82WEST12345698765432
{{$randomTransactionType}}A random transaction typepayment
{{$randomCurrencyCode}}A random 3-letter currency code (ISO-4217)EUR
{{$randomCurrencyName}}A random currency nameUS Dollar
{{$randomCurrencySymbol}}A random currency symbol
{{$randomBitcoin}}A random bitcoin address1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa

Business

VariableDescriptionExample
{{$randomCompanyName}}A random company nameTechStart Solutions
{{$randomCompanySuffix}}A random company suffixLLC
{{$randomBs}}A random phrase of business-speakstreamline innovative platforms
{{$randomBsAdjective}}A random business-speak adjectivedynamic
{{$randomBsBuzz}}A random business-speak buzzwordoptimize
{{$randomBsNoun}}A random business-speak nounsolutions

Catchphrases

VariableDescriptionExample
{{$randomCatchPhrase}}A random catchphraseInnovative scalable methodology
{{$randomCatchPhraseAdjective}}A random catchphrase adjectiveRobust
{{$randomCatchPhraseDescriptor}}A random catchphrase descriptorcloud-based
{{$randomCatchPhraseNoun}}A random catchphrase nounframework

Databases

VariableDescriptionExample
{{$randomDatabaseColumn}}A random database column nameuserId
{{$randomDatabaseType}}A random database typevarchar
{{$randomDatabaseCollation}}A random database collationutf8_unicode_ci
{{$randomDatabaseEngine}}A random database engineInnoDB

Dates

VariableDescriptionExample
{{$randomDateFuture}}A random future datetime2027-11-05T18:30:22.000Z
{{$randomDatePast}}A random past datetime2023-08-14T15:45:33.000Z
{{$randomDateRecent}}A random recent datetime2026-02-07T10:20:15.000Z
{{$randomWeekday}}A random weekdayMonday
{{$randomMonth}}A random monthSeptember

Domains, Emails and Usernames

VariableDescriptionExample
{{$randomDomainName}}A random domain nametest-site.net
{{$randomDomainSuffix}}A random domain suffixorg
{{$randomDomainWord}}A random unqualified domain namesample
{{$randomEmail}}A random email addresssample@gmail.com
{{$randomExampleEmail}}A random email address from an example domainalex.johnson@example.org
{{$randomUserName}}A random usernametechuser2024
{{$randomUrl}}A random URLhttps://demo-website.io

Files and Directories

VariableDescriptionExample
{{$randomSemver}}A random semantic version number3.12.4
{{$randomFileName}}A random file name (includes uncommon extensions)report_2024.pdf
{{$randomFileType}}A random file type (includes uncommon file types)video
{{$randomFileExt}}A random file extension (includes uncommon extensions)csv
{{$randomCommonFileName}}A random file namepresentation.pptx
{{$randomCommonFileType}}A random, common file typeimage
{{$randomCommonFileExt}}A random, common file extensionjpg
{{$randomFilePath}}A random file path/var/www/html/index.html
{{$randomDirectoryPath}}A random directory path/opt/apps
{{$randomMimeType}}A random MIME typeimage/jpeg

Stores

VariableDescriptionExample
{{$randomPrice}}A random price between 0.00 and 1000.00247.99
{{$randomProduct}}A random productShoes
{{$randomProductAdjective}}A random product adjectivePremium
{{$randomProductMaterial}}A random product materialCotton
{{$randomProductName}}A random product nameErgonomic Wooden Chair
{{$randomDepartment}}A random commerce categoryElectronics

Grammar

VariableDescriptionExample
{{$randomNoun}}A random nounnetwork
{{$randomVerb}}A random verbgenerate
{{$randomIngverb}}A random verb ending in -ingprocessing
{{$randomAdjective}}A random adjectiveefficient
{{$randomWord}}A random wordsystem
{{$randomWords}}Some random wordsquick brown fox jumps high
{{$randomPhrase}}A random phraseTry to compress the TCP protocol...

Lorem Ipsum

VariableDescriptionExample
{{$randomLoremWord}}A random word of lorem ipsum textipsum
{{$randomLoremWords}}Some random words of lorem ipsum textdolor sit amet
{{$randomLoremSentence}}A random sentence of lorem ipsum textSed ut perspiciatis unde omnis iste natus.
{{$randomLoremSentences}}A random 2 to 6 sentences of lorem ipsum textNemo enim ipsam voluptatem...
{{$randomLoremParagraph}}A random paragraph of lorem ipsum textLorem ipsum dolor sit amet...
{{$randomLoremParagraphs}}3 random paragraphs of lorem ipsum textVoluptatem rem magnam...
{{$randomLoremText}}A random amount of lorem ipsum textTemporibus autem quibusdam...
{{$randomLoremSlug}}A random lorem ipsum URL sluglorem-ipsum-dolor
{{$randomLoremLines}}1 to 7 random lines of lorem ipsumSed ut perspiciatis unde...

Variables with arguments

The following dynamic variables support optional arguments for customization. Use the handlebars hash syntax to pass arguments.

Common

Arguments: version (4|7), refDate
{{$guid 7}}
{{$guid 4 "2026-01-01"}}
Arguments: version (4|7), refDate
{{$randomUUID 7}}
{{$randomUUID 4 "2026-01-01"}}

Text, Numbers and Colors

Arguments: length | (min max), casing (upper|lower|mixed), exclude
{{$randomAlphaNumeric 5}}
{{$randomAlphaNumeric 3 8 "upper"}}
Arguments: probability (0-1)
{{$randomBoolean 0.8}}
Arguments: max | (min max), multipleOf
{{$randomInt 100}}
{{$randomInt 1 100}}
{{$randomInt 0 100 5}}
Arguments: format (hex|css|binary), includeAlpha (true|false), prefix, casing (upper|lower|mixed)
{{$randomHexColor "css"}}
{{$randomHexColor "hex" "true" "#" "upper"}}

Internet and IP Addresses

Arguments: cidrBlock | network
{{$randomIP "192.168.0.0/16"}}
Arguments: separator
{{$randomMACAddress "-"}}
Arguments: length, memorable (true|false), pattern, prefix
{{$randomPassword 20}}
{{$randomPassword 12 "true"}}

Names

Arguments: gender (male|female)
{{$randomFirstName "male"}}
Arguments: gender (male|female)
{{$randomLastName "female"}}
Arguments: gender (male|female)
{{$randomFullName "male"}}
Arguments: gender (male|female)
{{$randomNamePrefix "female"}}

Phone, Address and Location

Arguments: style (human|national|international)
{{$randomPhoneNumber "international"}}
Arguments: useFullAddress (true|false)
{{$randomStreetAddress "true"}}
Arguments: variant (alpha-2|alpha-3|numeric)
{{$randomCountryCode "alpha-3"}}
Arguments: max | (min max), precision
{{$randomLatitude 50}}
{{$randomLatitude -10 50 4}}
Arguments: max | (min max), precision
{{$randomLongitude 100}}
{{$randomLongitude -100 100 4}}

Images

Arguments: width, height
{{$randomImageUrl 800 600}}
Arguments: width, height, color, type (svg-uri|svg-base64)
{{$randomImageDataUri 200 200 "blue" "svg-base64"}}

Finance

Arguments: length (default 8)
{{$randomBankAccount 10}}
Arguments: issuer
{{$randomCreditCardMask "visa"}}
Arguments: includeBranchCode (true|false)
{{$randomBankAccountBic "true"}}
Arguments: formatted (true|false), countryCode
{{$randomBankAccountIban "true" "DE"}}
Arguments: type (legacy|segwit|bech32), network (mainnet|testnet)
{{$randomBitcoin "segwit" "mainnet"}}

Dates

Arguments: years, refDate
{{$randomDateFuture 5}}
{{$randomDateFuture 2 "2025-01-01"}}
Arguments: years, refDate
{{$randomDatePast 3}}
{{$randomDatePast 1 "2024-06-01"}}
Arguments: days, refDate
{{$randomDateRecent 7}}
{{$randomDateRecent 30 "2026-01-01"}}
Arguments: abbreviated (true|false), context (true|false)
{{$randomWeekday "true"}}
Arguments: abbreviated (true|false), context (true|false)
{{$randomMonth "true"}}

Domains, Emails and Usernames

Arguments: firstName, lastName, provider, allowSpecialCharacters (true|false)
{{$randomEmail "John"}}
{{$randomEmail "John" "Doe" "gmail.com"}}
Arguments: firstName, lastName, allowSpecialCharacters (true|false)
{{$randomExampleEmail "John" "Doe"}}
Arguments: firstName, lastName
{{$randomUserName "John" "Doe"}}
Arguments: protocol (http|https), appendSlash (true|false)
{{$randomUrl "https" "true"}}

Files and Directories

Arguments: extensionCount | (min max)
{{$randomFileName 2}}
{{$randomFileName 1 3}}
Arguments: mimeType
{{$randomFileExt "image/jpeg"}}

Stores

Arguments: max | (min max), dec, symbol
{{$randomPrice 500}}
{{$randomPrice 10 100 2 "$"}}

Grammar

Arguments: length | (min max), strategy (fail|closest|shortest|longest|any-length)
{{$randomNoun 5}}
{{$randomNoun 3 8 "closest"}}
Arguments: length | (min max), strategy (fail|closest|shortest|longest|any-length)
{{$randomVerb 5}}
{{$randomVerb 3 8 "closest"}}
Arguments: length | (min max), strategy (fail|closest|shortest|longest|any-length)
{{$randomAdjective 5}}
{{$randomAdjective 3 8 "closest"}}
Arguments: length | (min max), strategy (fail|closest|shortest|longest|any-length)
{{$randomWord 5}}
{{$randomWord 3 8 "closest"}}
Arguments: count | (min max)
{{$randomWords 3}}
{{$randomWords 2 5}}

Lorem Ipsum

Arguments: length | (min max), strategy (fail|closest|shortest|longest|any-length)
{{$randomLoremWord 5}}
{{$randomLoremWord 3 8 "closest"}}
Arguments: count | (min max)
{{$randomLoremWords 5}}
{{$randomLoremWords 3 7}}
Arguments: wordCount | (min max)
{{$randomLoremSentence 10}}
{{$randomLoremSentence 5 12}}
Arguments: count | (min max), separator
{{$randomLoremSentences 3}}
{{$randomLoremSentences 2 5}}
Arguments: sentenceCount | (min max)
{{$randomLoremParagraph 5}}
{{$randomLoremParagraph 3 7}}
Arguments: count | (min max), separator
{{$randomLoremParagraphs 5}}
{{$randomLoremParagraphs 2 4}}
Arguments: count | (min max)
{{$randomLoremSlug 5}}
{{$randomLoremSlug 2 4}}
Arguments: count | (min max)
{{$randomLoremLines 3}}
{{$randomLoremLines 2 5}}

What’s Next?