Skip to main content

Custom Template Usage

Mockify gives you access to over 250 types of fake data — but why stop there? With our flexible placeholder system, you can design your own custom data structures using simple JSON and dynamic tokens. Just drop in placeholders that resemble our API endpoints, and Mockify will instantly generate realistic mock data for you. It’s fast, flexible, and perfect for any testing or prototyping workflow. The below is an example for a custom template usage:

The template belowGives this data
{
  "first_name": "{{person/firstname?gender=female}}",
  "file": "{{system/common-file-name?extension=png}}",
  "date": "{{date/recent?days=30}}",
  "company": "{{company/name}}",
  "years": "{{number/int?min=1&max=3}}"
}
{
  "first_name": "Camille",
   "file": "fold.png",
  "date": "2025-03-21T13:03:03.075Z",
  "company": "Jenkins LLC"
  "years": 2
}`

You can use all the 250+ fake data endpoints in the placeholder tokens and its customizable params. The below sections lists all the placeholder tokens and its parameters.

Airline

The below table lists all the placeholder tokens available for airline data.

Placeholder TokenParameters                   DataExample                                 
airline/aircraft-typeNILrandom aircraft type{{ airline/aircraft-type }}
airline/airlineNILrandom airline{{ airline/airline }}
airline/airplaneNILrandom airplane{{ airline/airplane }}
airline/airportNILrandom airport details{{ airline/airport }}
airline/flight-numberNILrandom flight number{{ airline/flight-number }}
airline/record-locatorNILrandom record locator{{ airline/record-locator }}
airline/seatNILrandom seat number{{ airline/seat }}
airline/flight-detailsNILflight details{{ airline/flight-details }}

Animal

The below table lists all the placeholder tokens available for animal data.

Placeholder TokenParameters                   DataExample                                 
animal/bearNILrandom bear species{{ animal/bear }}
animal/birdNILrandom bird species{{ animal/bird }}
animal/catNILrandom cat breed{{ animal/cat }}
animal/cetaceanNILrandom cetacean breed{{ animal/cetacean }}
animal/cowNILrandom cow breed{{ animal/cow }}
animal/crocodiliaNILrandom crocodilian species{{ animal/crocodilia }}
animal/dogNILrandom dog breed{{ animal/dog }}
animal/fishNILrandom fish species{{ animal/fish }}
animal/horseNILrandom horse breed{{ animal/horse }}
animal/insectNILrandom insect species{{ animal/insect }}
animal/lionNILrandom lion species{{ animal/lion }}
animal/pet-nameNILrandom pet name{{ animal/pet-name }}
animal/rabbitNILrandom rabbit breed{{ animal/rabbit }}
animal/rodentNILrandom rodent breed{{ animal/rodent }}
animal/snakeNILrandom snake species{{ animal/snake }}
animal/typeNILrandom animal type{{ animal/type }}

Book

The below table lists all the placeholder tokens available for book data.

Placeholder TokenParameters                   DataExample                                 
book/authorNILrandom author name{{ book/author }}
book/formatNILrandom book format{{ book/format }}
book/genreNILrandom genre{{ book/genre }}
book/publisherNILrandom publisher{{ book/publisher }}
book/seriesNILrandom series{{ book/series }}
book/titleNILrandom title{{ book/title }}
book/isbnNILrandom ISBN{{ book/isbn }}
book/detailsNILrandom book details{{ book/details }}

Color

The below table lists all the placeholder tokens available for color data.

Placeholder TokenParameters                   DataExample                                 
color/cmykformat - either decimal, css or binaryrandom CMYK color{{ color/cmyk }},
{{ color/cmyk?format=decimal }}
color/css-color-spaceNILrandom CSS color space{{ color/css-color-space }}
color/css-supported-functionNILrandom CSS supported color function name{{ color/css-supported-function }}
color/css-supported-spaceNILrandom CSS supported space name{{ color/css-supported-space }}
color/hslformat - either decimal, css or binary
include-alpha - either true or false
random HSL color{{ color/hsl }}
color/humanNILrandom human-readable color name{{ color/human }}
color/hwbformat - either decimal, css or binaryrandom HWB color{{ color/hwb }}
color/labformat - either decimal, css or binaryrandom LAB (CIELAB) color{{ color/lab }}
color/lchformat - either decimal, css or binaryrandom LCH (Lightness, Chroma, Hue) color{{ color/lch }}
color/rgbformat - either decimal, css or binary
casing - either lower or upper
include-alpha - either true or false
prefix - prefix character to be used
random RGB color{{ color/rgb }}
{{ color/rgb?casing=upper }}
{{ color/rgb?format=hex&prefix=$&include-alpha=true&casing=upper }}
color/spaceNILrandom color space{{ color/space }}

Commerce

The below table lists all the placeholder tokens available for commerce data.

Placeholder TokenParameters                   DataExample                                 
commerce/departmentNILrandom department inside a shop{{ commerce/department }}
commerce/pricedecimal - the number of decimal places
min - the minimum price
max - the maximum price
currency - the currency symbol
random price{{ commerce/price }}
{{ commerce/price?min=1000&max=10000 }}
{{ commerce/price?decimal=1 }}
{{ commerce/price?currency=USD }}
commerce/productNILrandom short product name{{ commerce/product }}
commerce/product-adjectiveNILrandom adjective describing a product{{ commerce/product-adjective }}
commerce/product-descriptionNILrandom product description{{ commerce/product-description }}
commerce/product-materialNILrandom product material{{ commerce/product-material }}
commerce/product-nameNILrandom product name{{ commerce/product-name }}

Company

The below table lists all the placeholder tokens available for company data.

Placeholder TokenParameters                   DataExample                                 
company/buzz-adjectiveNILrandom buzz adjective{{ company/buzz-adjective }}
company/buzz-nounNILrandom buzz noun{{ company/buzz-noun }}
company/buzz-phraseNILrandom buzz phrase{{ company/buzz-phrase }}
company/buzz-verbNILrandom buzz verb{{ company/buzz-verb }}
company/catch-phraseNILrandom catch phrase{{ company/catch-phrase }}
company/catch-phrase-adjectiveNILrandom catch phrase adjectiven{{ company/catch-phrase-adjective }}
company/catch-phrase-descriptorNILrandom catch phrase{{ company/catch-phrase-descriptor }}
company/catch-phrase-nounNILrandom catch phrase{{ company/catch-phrase-noun }}
company/nameNILrandom company name{{ company/name }}

Database

The below table lists all the placeholder tokens available for database data.

Placeholder TokenParameters                   DataExample                                 
database/collationNILrandom database collation{{ database/collation }}
database/columnNILrandom database column{{ database/column }}
database/engineNILrandom database engine{{ database/engine }}
database/mongodb-object-idNILrandom mongodb object id{{ database/mongodb-object-id }}
database/typeNILrandom database type{{ database/type }}

Datatype

The below table lists all the placeholder tokens available for datatype data.

Placeholder TokenParameters                   DataExample                                 
datatype/booleanNILrandom boolean value true or false{{ datatype/boolean }}

Date

The below table lists all the placeholder tokens available for date data.

Placeholder TokenParameters                   DataExample                                 
date/anytimeNILrandom date at anytime{{ date/anytime }}
date/betweenfrom - the starting date
to - the end date
random date between two given dates{{ date/between }}
{{ date/between?from=2025-02-02 }}
{{ date/between?to=2025-02-02 }}
date/betweensfrom - the starting date
to - the end date
count - the number of days
random date between two given dates with number of days{{ date/betweens }}
{{ date/betweens?from=2025-01-02&to=2025-02-02&count=5 }}
date/birthdateref-data - the reference date to use
mode - either age or year
min - the minimum age or year
max - the maximum age or year
random birthdate{{ date/birthdate?ref-date=2025-05-1 }}
{{ date/birthdate?ref-mode=year&min=18&max=80 }}
date/futureref-data - the reference date to use
years - range of years
random date in the future{{ date/future }}
{{ date/future?ref-date=2025-04-01&years=2 }}
date/monthabbreviated - whether to return an abbreviation
context - whether to return the name of a month in the context of a date, either true or false
random month name{{ date/month }}
{{ date/month?abbreviated=true&context=true }}
date/pastref-data - the reference date to use
years - range of years
random date in the past{{ date/past }}
{{ date/past?ref-data=2025-01-01&years=3 }}
date/recentref-data - the reference date to use
days - number of of days
random date in the recent past{{ date/recent }}
{{ date/recent?ref-data=2025-01-01&days=30 }}
date/soonref-data - the reference date to use
days - number of of days
random date in the near future soon{{ date/soon }}
{{ date/soon?ref-data=2025-01-01&days=30 }}
date/time-zoneNILrandom IANA time zone name{{ date/time-zone }}
date/weekdayabbreviated - whether to return an abbreviation
context - whether to return the name of a month in the context of a date, either true or false
random company weekday{{ date/weekday }}
{{ date/weekday?abbreviated=true&context=true }}

Finance

The below table lists all the placeholder tokens available for finance data.

Placeholder TokenParameters                   DataExample                                 
finance/account-nameNILrandom account name{{ finance/account-name }}
finance/account-numberNILrandom account number{{ finance/account-number }}
finance/amountmin - the minimum amount
max - the maximum amount
decimal - the number of decimal places
auto-format - if true this method will use Number.toLocaleString(). Otherwise it will use Number.toFixed().days
symbol - symbol used to prefix the amount
random amount between the given bounds (inclusive){{ finance/amount }}
{{ finance/amount?min=100&max=10000 }}
{{ finance/amount?currency=$100$&auto-format=true }}
finance/bicinclude-branch-code - if true this will include a three-digit branch code at the end of the generated coderandom SWIFT/BIC code based on the ISO-9362 format{{ finance/bic }}
{{ finance/bic?include-branch-code=true }}
finance/bitcoin-addresstype - The bitcoin address type ('legacy', 'sewgit', 'bech32' or 'taproot')
network - The bitcoin network type ('mainnet' or 'testnet')
random bitcoin address{{ finance/bitcoin-address }}
{{ finance/bitcoin-address?type=sewgit&network=mainnet }}
finance/credit-card-cvvNILrandom credit card CVV{{ finance/credit-card-cvv }}
finance/credit-card-issuerNILrandom credit card issuer{{ finance/credit-card-issuer }}
finance/credit-card-numbercredit card number - name of the issuer (case-insensitive) like Visa or the format used to generate one like 63[7-9]#-####-####-###L.random credit card number{{ finance/credit-card-number }}
{{ finance/credit-card-number?issuer=visa }}
{{ finance/credit-card-number?issuer=63[7-9]#-####-####-### }}
finance/currencyNILrandom currency object, containing code, name and symbol properties{{ finance/currency }}
finance/currency-codeNILrandom currency code{{ finance/currency-code }}
finance/currency-nameNILrandom currency name{{ finance/currency-name }}
finance/currency-symbolNILrandom currency symbol{{ finance/currency-symbol }}
finance/ethereum-addressNILrandom Ethereum address{{ finance/ethereum-address }}
finance/ibanformatted - formatted version of the generated IBAN
country-code - country code from which you want to generate an IBAN
random random IBAN{{ finance/iban }}
{{ finance/iban?formatted=true&country-code=DE }}
finance/litecoin-addressNILrandom Litecoin address{{ finance/litecoin-address }}
finance/pinlength - length of the PIN to generate
random pin number{{ finance/pin }}
{{ finance/pin?length=4 }}
finance/routing-numberNILrandom routing number{{ finance/routing-number }}
finance/transaction-descriptionNILrandom transaction description{{ finance/transaction-description }}
finance/transaction-typeNILrandom transaction type{{ finance/transaction-type }}

Food

The below table lists all the placeholder tokens available for food data.

Placeholder TokenParameters                   DataExample                                 
food/adjectiveNILrandom dish adjective{{ food/adjective }}
food/descriptionNILrandom dish description{{ food/description }}
food/dishNILrandom dish{{ food/dish }}
food/ethnic-categoryNILrandom food's ethnic category{{ food/ethnic-category }}
food/fruitNILrandom fruit name{{ food/fruit }}
food/ingredientNILrandom ingredient name{{ food/ingredient }}
food/meatNILrandom spice name{{ food/meat }}
food/spiceNILrandom catch phrase{{ food/spice }}
food/vegetableNILrandom vegetable name{{ food/vegetable }}

Git

The below table lists all the placeholder tokens available for git data.

Placeholder TokenParameters                   DataExample                                 
git/branchNILrandom branch name{{ git/branch }}
git/commit-dateref-data - the reference date to use
random commit date{{ git/commit-date }}
{{ git/commit-date?ref-date=2025-01-01 }}
git/commit-entryref-data - the reference date to use
eol - the end of line character to use
merge - true to generate a merge message line
random entry as printed by git log{{ git/commit-entry }}
{{ git/commit-entry?eol=CRLF&merge=true }}
git/commit-messageNILrandom commit message{{ git/commit-message }}
git/commit-shalength - length of the commit SHA
random commit sha{{ git/commit-sha }}
{{ git/commit-sha?length=8 }}

Hacker

The below table lists all the placeholder tokens available for hacker data.

Placeholder TokenParameters                   DataExample                                 
hacker/abbreviationNILrandom hacker/IT abbreviation{{ hacker/abbreviation }}
hacker/adjectiveNILrandom hacker/IT adjective{{ hacker/adjective }}
hacker/ingverbNILrandom hacker/IT verb for continuous actions (en: ing suffix; e.g. hacking){{ hacker/ingverb }}
hacker/nounNILrandom food'hacker/IT noun{{ hacker/noun }}
hacker/phraseNILrandom hacker/IT phrase{{ hacker/phrase }}
hacker/verbNILrandom hacker/IT verb{{ hacker/verb }}

Image

The below table lists all the placeholder tokens available for image data.

Placeholder TokenParameters                   DataExample                                 
image/avatarNILrandom avatar image url{{ image/avatar }}
image/avatar-githubNILrandom avatar from github{{ image/avatar-github }}
image/data-uriwidth - the width of the image
height - the height of the image
color - color of the image, must be supported by svg
type - type of the image to return (either svg-uri or svg-base64)
random data uri containing an URL-encoded SVG image or a Base64-encoded SVG image{{ image/data-uri }}
{{ image/data-uri?width=512&height=512 }}
{{ image/data-uri?type=svg-base64&color=#df07bc }}
image/person-portraitgender - the gender (either male or female)
size - the size of the image (should be one of 512, 256, 128, 64, 32)
random square portrait of a person{{ image/person-portrait }}
{{ image/person-portrait?gender=female }}
{{ image/person-portrait?size=512 }}
image/urlwidth - the width of the image
height - the height of the image
random random image url{{ image/url }}
{{ image/url?width=1024&height=1024 }}
image/url-lorem-flickrwidth - the width of the image
height - the height of the image
category - the category of the image
random image url via https://loremflickr.com{{ image/url-lorem-flickr }}
{{ image/url-lorem-flickr?width=1024&height=1024 }}
{{ image/url-lorem-flickr?category=nature }}
image/url-picsum-photoswidth - the width of the image
height - the height of the image
grayscale - whether the image should be grayscale
blur - whether the image should be blurred. 0 disables the blur. Value should be 0 to 10
random random image url via https://picsum.photos{{ image/url-picsum-photos }}
{{ image/url-picsum-photos?width=1024&height=1024 }}
{{ image/url-picsum-photos?grayscale=true&blur=4 }}

Internet

The below table lists all the placeholder tokens available for internet data.

Placeholder TokenParameters                   DataExample                                 
internet/colorNILrandom aesthetically pleasing color code{{ internet/color }}
internet/display-namefirst-name - the first name of the person
last-name - the last name of the person
random display name{{ internet/display-name }}
internet/domain-nameNILrandom domain name{{ internet/domain-name }}
internet/domain-suffixNILrandom domain suffix{{ internet/domain-suffix }}
internet/domain-wordNILrandom domain word{{ internet/domain-word }}
internet/emailallow-special-characters - whether special characters should be included
first-name - the first name of the person
last-name - the last name of the person
provider - the mail provider domain to use
random email address{{ internet/email }}
{{ internet/email?first-name=John }}
{{ internet/email?provider=example.mockify.dev }}
internet/emojiNILrandom emoji{{ internet/emoji }}
internet/example-emailallow-special-characters - whether special characters should be included
first-name - the first name of the person
last-name - the last name of the person
random example email address{{ internet/example-email }}
internet/http-methodNILrandom HTTP method name{{ internet/http-method }}
internet/http-status-codeNILrandom HTTP status code{{ internet/http-status-code }}
internet/ipNILrandom IPv4 or IPv6 address{{ internet/ip }}
internet/ipv4NILrandom IPv4{{ internet/ipv4 }}
internet/ipv6NILrandom IPv6 address{{ internet/ipv6 }}
internet/jwtNILrandom JWT token{{ internet/jwt }}
internet/jwt-algorithmNILrandom JWT algorithm{{ internet/jwt-algorithm }}
internet/macNILrandom mac address{{ internet/mac }}
internet/passwordlength - length of the password
memorable - whether the generated password should be memorable
pattern - pattern that all chars should match
prefix - prefix to use
random password-like string{{ internet/password }}
{{ internet/password }}
{{ internet/password?memorable=true }}
{{ internet/password?pattern=/[A-Z]/ }}
{{ internet/password?prefix=hello }}
internet/portNILrandom port umber.{{ internet/port }}
internet/protocolNILrandom web protocol either http or https{{ internet/protocol }}
internet/urlappend-slash - whether to append a slash to the end of the url
protocol - the protocol to use
random http(s) url{{ internet/url }}
{{ internet/url?protocol=http }}
{{ internet/url?append-slash=false }}
internet/user-agentNILrandom user agent string{{ internet/user-agent }}
internet/usernamefirst-name - the first name of the person
last-name - the last name of the person
random user name{{ internet/username }}
{{ internet/username?first-name=john&last-name=doe }}

Location

The below table lists all the placeholder tokens available for location data.

Placeholder TokenParameters                   DataExample                                 
location/building-numberNILrandom building number{{ location/building-number }}
location/cardinal-directionabbreviated - if true this will return abbreviated directions (N, E, etc). Otherwise this will return the long name.
random cardinal direction{{ location/cardinal-direction }}
{{ location/cardinal-direction?abbreviated=true }}
location/cityNILrandom city name{{ location/city }}
location/continentNILrandom continent name{{ location/continent }}
location/countryNILrandom country name{{ location/country }}
location/country-codeNILrandom country code{{ location/country-code }}
location/countyNILrandom county name{{ location/county }}
location/directionabbreviated - if true this will return abbreviated directions (N, E, etc). Otherwise this will return the long name.
random direction{{ location/direction }}
{{ location/direction?abbreviated=true }}
location/languageNILrandom spoken language{{ location/language }}
location/latitudemin - lower bound for the latitude to generate
max - upper bound for the latitude to generate
precision - number of decimal points of precision for the latitude
random latitude{{ location/latitude }}
{{ location/latitude?min=45&max=-45&precision=2 }}
location/longitudemin - lower bound for the latitude to generate
max - upper bound for the latitude to generate
precision - number of decimal points of precision for the latitude
random longitude{{ location/longitude }}
{{ location/longitude?min=45&max=-45&precision=2 }}
location/nearby-gps-coordinatelat - latitude coordinate to get a new coordinate close to
lng - longitude coordinate to get a new coordinate close to
radius - maximum distance from the given coordinate to the new coordinate
radius - if true assume the radius to be in kilometers. If false for miles
random GPS coordinate{{ location/nearby-gps-coordinate }}
{{ location/nearby-gps-coordinate?lat=45&lng=-45&raidus=5&is-metric=true }}
location/ordinal-directionabbreviated - if true this will return abbreviated directions (N, E, etc). Otherwise this will return the long name.
random ordinal direction{{ location/ordinal-direction }}
{{ location/ordinal-direction?abbreviated=true }}
location/secondary-addressNILrandom secondary address{{ location/secondary-address }}
location/stateabbreviated - if true this will return abbreviated first-level administrative entity names. Otherwise this will return the long name.random localized state{{ location/state }}
location/streetNILrandom localized street name.{{ location/street }}
location/street-addressNILrandom localized street address{{ location/street-address }}
location/time-zoneNILrandom IANA time zone relevant to this locale.{{ location/time-zone }}
location/zip-codeformat - The optional format used to generate the zip code.random zip code from specified format{{ location/zip-code }}
.{{ location/zip-code?format=#### }}

Lorem

The below table lists all the placeholder tokens available for lorem data.

Placeholder TokenParameters                   DataExample                                 
lorem/linesmin - minimum number of lines to generate
max - maximum number of lines to generate
lines - number of lines to generate
random number of lines{{ lorem/lines }}
{{ lorem/lines?min=1&max=3 }}
{{ lorem/lines?lines=3 }}
lorem/paragraphmin - minimum number of sentences to generate
max - maximum number of sentences to generate
sentences - number of sentences to generate
random paragraph{{ lorem/paragraph }}
{{ lorem/paragraph?min=1&max=3 }}
{{ lorem/paragraph?lines=3 }}
lorem/paragraphsmin - minimum number of paragraphs to generate
max - maximum number of paragraphs to generate
paragraphs - number of paragraphs to generate
separator - separator to use
random number of paragraphs name{{ lorem/paragraphs }}
{{ lorem/paragraphs?min=1&max=3 }}
{{ lorem/paragraphs?paragraphs=3&separator=\n }}
lorem/sentencemin - minimum number of words to generate
max - maximum number of words to generate
words - number of words to generate
random space separated list of words{{ lorem/sentence }}
{{ lorem/sentence?min=1&max=3 }}
{{ lorem/sentence?words=3 }}
lorem/sentencesmin - minimum number of paragraphs to generate
max - maximum number of paragraphs to generate
paragraphs - number of paragraphs to generate
separator - separator to use
random number of sentences{{ lorem/sentences }}
{{ lorem/sentences?min=1&max=3 }}
{{ lorem/sentences?sentences=3&separator=\n }}
lorem/slugmin - minimum number of words to generate
max - maximum number of words to generate
words - number of words to generate
random slugified text{{ lorem/slug }}
{{ lorem/slug?min=1&max=3 }}
{{ lorem/slug?words=4 }}
lorem/textNILrandom text name{{ lorem/text }}
lorem/wordmin - minimum length to generate
max - maximum length to generate
length - length of the word
random word of a specified length{{ lorem/word }}
{{ lorem/word?min=3&max=5 }}
{{ lorem/word?length=5 }}
lorem/wordsmin - minimum number of words to generate
max - maximum number of words to generate
words - number of words to generate
random space separated list of words{{ lorem/words }}
{{ lorem/words?min=3&max=5 }}
{{ lorem/words?words=5 }}

Music

The below table lists all the placeholder tokens available for music data.

Placeholder TokenParameters                   DataExample                                 
music/albumNILrandom album name{{ music/album }}
music/artistNILrandom artist name{{ music/artist }}
music/genreNILrandom music genre{{ music/genre }}
music/song-nameNILrandom song name{{ music/song-name }}

Number

The below table lists all the placeholder tokens available for number data.

Placeholder TokenParameters                   DataExample                                 
number/big-intmin - lower bound for generated bigint
max - upper bound for generated bigint
random bigint number{{ number/big-int }}
{{ number/big-int?min=10&max=10000 }}
number/binarymin - lower bound for generated number
max - upper bound for generated number
random binary number{{ number/binary }}
{{ number/binary?min=10&max=10000 }}
number/floatmin - lower bound for generated number
max - upper bound for generated number
digits - maximum number of digits to appear after the decimal point
multiple-of - generated number will be a multiple of this parameter
random floating-point number{{ number/float }}
{{ number/float?min=1&max=100 }}
{{ number/float?digits=2&multiple-of=2 }}
number/hexmin - lower bound for generated hex
max - upper bound for generated hex
random hexadecimal number{{ number/hex }}
{{ number/hex?min=10&max=10000 }}
number/intmin - lower bound for generated number
max - upper bound for generated number
multiple-of - generated number will be a multiple of this parameter
random integer number{{ number/int }}
{{ number/int?min=1&max=100 }}
{{ number/int?multiple-of=2 }}
number/octalmin - lower bound for generated octal
max - upper bound for generated octal
random octal number{{ number/octal }}
{{ number/octal?min=1&max=100 }}
number/roman-numeralmin - lower bound for generated roman numeral
max - upper bound for generated roman numeral
random roman numeral in String format{{ number/roman-numeral }}
{{ number/roman-numeral?min=1&max=100 }}

Person

The below table lists all the placeholder tokens available for person data.

Placeholder TokenParameters                   DataExample                                 
person/firstnamegender - optional gender to use. Can be either 'female' or 'male'.random first name{{ person/firstname }}
{{ person/firstname?gender=female }}
person/middlenamegender - optional gender to use. Can be either 'female' or 'male'.random middle name{{ person/middlename }}
{{ person/middlename?gender=female }}
person/lastnamegender - optional gender to use. Can be either 'female' or 'male'.random last name{{ person/lastname }}
{{ person/lastname?gender=female }}
person/fullnamegender - optional gender to use. Can be either 'female' or 'male'.
firstname - optional firstname to use
lastname - optional lastname to use
random full name{{ person/fullname }}
{{ person/fullname?gender=female }}
{{ person/fullname?firstname=John }}
person/genderbinary - whether to return either male or femalerandom gender name{{ person/gender }}
{{ person/gender?binary=false }}
person/prefixgender - optional gender to use. Can be either 'female' or 'male'.random prefix{{ person/prefix }}
{{ person/prefix?gender=female }}
person/suffixNILrandom suffix name{{ person/suffix }}
person/collective-namegender - optional gender to use. Can be either 'female' or 'male'.random collective name including prefix and suffix{{ person/collective-name }}
{{ person/collective-name?gender=female }}
person/bioNILrandom short biography{{ person/bio }}
person/job-areaNILrandom job area{{ person/job-area }}
person/job-descriptionNILrandom job description{{ person/job-description }}
person/job-titleNILrandom job title{{ person/job-title }}
person/job-typeNILrandom job type{{ person/job-type }}
person/jobNILrandom job details{{ person/job }}
person/zodiac-signNILrandom zodiac sign{{ person/zodiac-sign }}
person/photogender - optional gender to use. Can be either 'female' or 'male'
size - size of the image. Can be 512, 256, 128, 64 or 32
random square photo of a person{{ person/photo }}
{{ person/photo?size=512 }}
person/profilegender - optional gender to use. Can be either 'female' or 'male'
random person details including all the details above{{ person/profile }}
{{ person/profile?gender=female }}

Phone

The below table lists all the placeholder tokens available for phone data.

Placeholder TokenParameters                   DataExample                                 
phone/imeiNILrandom IMEI number{{ phone/imei }}
phone/numberstyle - Style of the generated phone number: 'human': (default) A human-input phone number, e.g. 555-770-7727 or 555.770.7727 x1234. 'national': A phone number in a standardized national format, e.g. (555) 123-4567. 'international': A phone number in the E.123 international format, e.g. +15551234567random phone number{{ phone/number }}
{{ phone/number?style=national }}

Science

The below table lists all the placeholder tokens available for science data.

Placeholder TokenParameters                   DataExample                                 
science/chemical-elementNILrandom periodic table element{{ science/chemical-element }}
science/unitNILrandom scientific unit{{ science/unit }}

String

The below table lists all the placeholder tokens available for string data.

Placeholder TokenParameters                   DataExample                                 
string/alphaexclude - list of characters to be excluded
min - lower bound for generated characters
max - upper bound for generated characters
length - length of the string to generate either as a fixed length
casing - casing of the characters
random string consisting of letters in the English alphabet{{ string/alpha }}
{{ string/alpha?min=3&max=5 }}
{{ string/alpha?length=10&casing=upper }}
{{ string/alpha?exclude=aeiou }}
string/alphanumericexclude - list of characters to be excluded
min - lower bound for generated characters
max - upper bound for generated characters
length - length of the string to generate either as a fixed length
casing - casing of the characters
random string consisting of alpha characters and digits{{ string/alphanumeric }}
{{ string/alphanumeric?min=3&max=5 }}
{{ string/alphanumeric?length=10&casing=upper }}
{{ string/alphanumeric?exclude=aeiou }}
string/binarymin - lower bound for generated characters
max - upper bound for generated characters
length - length of the string to generate either as a fixed length
prefix - prefix for the generated binary
random binary string{{ string/binary }}
{{ string/binary?min=10&max=10 }}
{{ string/binary?length=10&prefix=bin_ }}
string/from-charactersmin - lower bound for generated characters
max - upper bound for generated characters
length - length of the string to generate either as a fixed length
characters - characters to use for the string
random string from the given characters{{ string/from-characters }}
{{ string/from-characters?min=3&max=10 }}
{{ string/from-characters?length=10 }}
{{ string/from-characters?characters=aeiou }}
string/hexadecimalmin - lower bound for generated characters
max - upper bound for generated characters
length - length of the string to generate either as a fixed length
casing - casing of the characters
prefix - prefix for the generated hexadecimal
random hexadecimal string{{ string/hexadecimal }}
{{ string/hexadecimal?min=3&max=10 }}
{{ string/hexadecimal?length=10 }}
{{ string/hexadecimal?casing=upper&prefix=hex_ }}
string/nanoidmin - lower bound for Nano ID to generate
max - upper bound for Nano ID to generate
length - length of the string to generate either as a fixed length
random Nano ID{{ string/nanoid }}
{{ string/nanoid?min=3&max=5 }}
{{ string/nanoid?length=5 }}
string/numericexclude - list of characters to be excluded
min - lower bound for generated characters
max - upper bound for generated characters
length - length of the string to generate either as a fixed length
allow-leading-zeros - whether leading zeros are allowed or not
random string of digits{{ string/numeric }}
{{ string/numeric?min=3&max=5 }}
{{ string/numeric?exclude=ae }}
{{ string/numeric?allow-leading-zeros=false }}
string/octalmin - lower bound for generated characters
max - upper bound for generated characters
length - length of the string to generate either as a fixed length
prefix - prefix for the generated binary
random octal string{{ string/octal }}
{{ string/octal?min=3&max=5 }}
{{ string/octal?length=7&prefix=d }}
string/samplemin - lower bound for generated characters
max - upper bound for generated characters
length - length of the string to generate either as a fixed length
random string{{ string/sample }}
{{ string/sample?min=3&max=5 }}
{{ string/sample?length=7&prefix=d }}
string/symbolmin - lower bound for generated characters
max - upper bound for generated characters
length - length of the string to generate either as a fixed length
random string containing only special characters{{ string/symbol }}
{{ string/symbol?min=3&max=5 }}
{{ string/symbol?length=7 }}
string/ulidref-data - the reference date to use
random ULID{{ string/ulid }}
{{ string/ulid?ref-date=2025-01-01 }}
string/uuidNILrandom UUID v4{{ string/uuid }}

System

The below table lists all the placeholder tokens available for system data.

Placeholder TokenParameters                   DataExample                                 
system/common-file-extNILrandom file name with a given extension or a commonly used extension{{ system/common-file-ext }}
system/common-file-nameextension - file extension to use. Empty string is considered to be not setrandom random file name{{ system/common-file-name }}
{{ system/common-file-name?extension=jpg }}
system/common-file-typeNILrandom commonly used file type{{ system/common-file-type }}
system/croninclude-non-standard - whether to include a @yearly, @monthly, @daily, etc
include-year - whether to include a year in the generated expression
random cron expression{{ system/cron }}
{{ system/cron?include-non-standard=true&include-year=false }}
system/directory-pathNILrandom directory path{{ system/directory-path }}
system/file-extmime-type - valid mime-typerandom file extension{{ system/file-ext }}
{{ system/file-ext?mime-type=application/json }}
system/file-nameextension-count - define how many extensions the file name should haverandom file name with extension{{ system/file-name }}
{{ system/file-name?extension-count=2 }}
system/file-pathNILrandom file path{{ system/file-path }}
system/file-typeNILrandom file type{{ system/file-type }}
system/mime-typeNILrandom mime type{{ system/mime-type }}
system/network-interfaceinterface-schema - interface schema. Can be one of index, slot, mac, pci
interface-type - interface type. Can be one of en, wl, ww
random network interface{{ system/network-interface }}
{{ system/network-interface?interface-schema=mac }}
{{ system/network-interface?interface-type=en }}
system/semverNILrandom semantic version{{ system/semver }}

Vehicle

The below table lists all the placeholder tokens available for vehicle data.

Placeholder TokenParameters                   DataExample                                 
vehicle/bicycleNILrandom type of bicycle{{ vehicle/bicycle }}
vehicle/colorNILrandom vehicle color{{ vehicle/color }}
vehicle/fuelNILrandom fuel type{{ vehicle/fuel }}
vehicle/manufacturerNILrandom manufacturer name{{ vehicle/manufacturer }}
vehicle/modelNILrandom vehicle model{{ vehicle/model }}
vehicle/typeNILrandom vehicle type{{ vehicle/type }}
vehicle/vehicleNILrandom vehicle{{ vehicle/vehicle }}
vehicle/vinNILrandom vehicle identification number (VIN){{ vehicle/vin }}
vehicle/vrmNILrandom vehicle registration number (Vehicle Registration Mark - VRM){{ vehicle/vrm }}

Word

The below table lists all the placeholder tokens available for word data.

Placeholder TokenParameters                   DataExample                                 
word/adjectivemin - lower bound for generated characters
max - upper bound for generated characters
length - length of the string to generate
random random adjective{{ word/adjective }}
{{ word/adjective?min=3&max=6 }}
{{ word/adjective?length=6 }}
word/adverbmin - lower bound for generated characters
max - upper bound for generated characters
length - length of the string to generate
random adverb{{ word/adverb }}
{{ word/adverb?min=3&max=6 }}
{{ word/adverb?length=6 }}
word/conjunctionmin - lower bound for generated characters
max - upper bound for generated characters
length - length of the string to generate
random conjunction{{ word/conjunction }}
{{ word/conjunction?min=3&max=6 }}
{{ word/conjunction?length=6 }}
word/interjectionmin - lower bound for generated characters
max - upper bound for generated characters
length - length of the string to generate
random random adjectiverandom interjection
word/nounmin - lower bound for generated characters
max - upper bound for generated characters
length - length of the string to generate
random noun{{ word/noun }}
{{ word/noun?min=3&max=6 }}
{{ word/noun?length=6 }}
word/prepositionmin - lower bound for generated characters
max - upper bound for generated characters
length - length of the string to generate
random preposition{{ word/preposition }}
{{ word/preposition?min=3&max=6 }}
{{ word/preposition?length=6 }}
word/samplemin - lower bound for generated characters
max - upper bound for generated characters
length - length of the string to generate
random sample{{ word/sample }}
{{ word/sample?min=3&max=6 }}
{{ word/sample?length=6 }}
word/verbmin - lower bound for generated characters
max - upper bound for generated characters
length - length of the string to generate
random verb{{ word/verb }}
{{ word/verb?min=3&max=6 }}
{{ word/verb?length=6 }}
word/wordsmin - lower bound for generated characters
max - upper bound for generated characters
count - number of words to return
random words{{ word/words }}
{{ word/words?min=3&max=6 }}
{{ word/words?length=6 }}

Helpers

The below table lists all the placeholder tokens available for helper data.

Placeholder TokenParameters                   DataExample                                 
helper/randomarray[] - list of items in an arrayreturns a random element from the given array{{ helper/random?array[]=N&array[]=NE&array[]=E&array[]=SE }}