Field types

Every field in a recipe has a type. The engine produces one value of that type per record. Each type below links to its parameters and a copyable example.

Some options work on every type — unique, emptyRate — and textual types also take length, case and character constraints. Those are listed once, in Field options.

Numbers & dates

Type Produces
autoint Auto-incrementing integer: 1, 2, 3, … Always unique and never empty.
integer Random integer.
decimal Random decimal number, rounded to precision places.
boolean true or false.
date Calendar date, written as yyyy-MM-dd. Defaults to 1970-01-01 through 2030-12-31.
datetime Date and time in UTC, written as RFC 3339 (2024-05-01T13:45:10Z). Defaults to one year either side of now.
datetimePart One integer part of a date or time.
timezoneOffset UTC offset in hours, in quarter-hour steps from -12 to +14.

Text

Type Produces
text Text of a given category: words and sentences, or localized themed values such as names, companies and cities.
enum A value picked from your list, optionally weighted.
template Text assembled from earlier fields of the same record.
regexp Text matching a regular expression.
pattern Text from a placeholder mask: ? becomes a letter and # a digit.

People

Type Produces
person A person as one object whose name, gender and e-mail agree. JSON and YAML nest it; other formats write compact JSON.
contact Contact details as one object: e-mail, phone and address.
email E-mail address built from a romanized name: mei.tanaka42@example.com.
username Account handle such as lars.eriksson318.
phone Phone number. Brazilian for country: BR (the default for por), North American otherwise.
age Human age in years.

Identifiers

Type Produces
uuid Random UUID version 4.
uuidv4 Same as uuid.
ulid ULID: 26 characters, sortable by creation time.
mongodbObjectId 24-character hexadecimal MongoDB ObjectId.
identifier National or business identifier with valid check digits.
isbn ISBN-10 or ISBN-13 with a valid check digit.
isbn10 ISBN-10. The check digit can be X.
isbn13 ISBN-13 with a valid check digit.
issn ISSN with a valid check digit.
semver Semantic version such as 2.14.7.
slug Lowercase ASCII slug of hyphen-joined words: baking-chess-hiking.

Internet & network

Type Produces
url URL with a random domain and path.
httpUrl Like url, restricted to http and https.
domainName Domain name such as litoral.com.
hostname Host name such as host-417.
fqdn Fully qualified domain name such as host-12.litoral.com.
ipv4 IPv4 address.
ipv6 IPv6 address in 2001::/16.
ip IPv4 or IPv6 address, half each.
cidr IPv4 or IPv6 network block such as 10.32.0.0/11.
mac Locally administered unicast MAC address.
port TCP/UDP port from 1 to 65535.

Web & HTTP

Type Produces
httpStatus Common HTTP status: 200, 201, 204, 400, 401, 403, 404, 409, 422, 429, 500, 503.
httpMethod GET, POST, PUT, PATCH, DELETE, HEAD or OPTIONS.
httpVersion HTTP/1.0, HTTP/1.1, HTTP/2 or HTTP/3.
userAgent Browser or API client user-agent string.
logLevel TRACE, DEBUG, INFO, WARN or ERROR.
jwt Unsigned JWT (alg: none) with sub, iat and exp claims. Never valid against a real verifier.

Geography

Type Produces
latitude Latitude in degrees.
longitude Longitude in degrees.
postcode Postal code: 12345-678 for BR, 12345 for US, 1234-567 otherwise.

Security & encoding

Type Produces
password Random password with at least one character of each enabled class.
hash Digest of an earlier field or of a template. Test data only: never describe md4/md5 values as secure.
creditCard 16-digit test card number starting with 999999, Luhn-valid and never a real card.
base64 Standard Base64 of random bytes.
binary Random bytes, encoded as text.
color Color value. rgb, rgba and cmyk are arrays in JSON and compact text elsewhere.

Structured

Type Produces
json Nested object, or array of objects, built from child fields. JSON and YAML nest it; other formats write compact JSON.

Catalog

Type Produces
country Sovereign states and territories with ISO codes, currency, calling code and population.
language Languages with ISO 639 codes and native names.
currency Currencies with ISO 4217 codes, symbols and minor units.
continent The seven continents.