Available gofakeit Patterns# These patterns can be used with gen(), gen_batch(), json_arr(), and array(). Patterns are case-insensitive. Parameters are separated from the function name by : and from each other by ,.
edg-lang # No parameters
gen('email')
# With parameters
gen('number:1,100')
# In a batch
gen_batch(1000, 100, 'email')
# In a JSON array
json_arr(1, 5, 'firstname')
# In a PostgreSQL/CockroachDB array
array(2, 4, 'word')yaml # No parameters
- gen('email')
# With parameters
- gen('number:1,100')
# In a batch
- gen_batch(1000, 100, 'email')
# In a JSON array
- json_arr(1, 5, 'firstname')
# In a PostgreSQL/CockroachDB array
- array(2, 4, 'word') Patterns are validated at config load time. A typo like gen('emial') produces a clear error instead of silently returning the literal string {emial}.
Address# Pattern Description Example addressFull address (street, city, state, zip, country) {street: 37802 Port Streetborough, city: Chesapeake, state: North Carolina, zip: 18508, country: Andorra}cityCity name MardarvillecountryCountry name United Statescountryabr2-letter country code USlatitudeLatitude coordinate 41.7886latituderange:0,90Latitude in range (default 0-90) 52.31longitudeLongitude coordinate -112.0591longituderange:0,180Longitude in range (default 0-180) 73.45stateState name Idahostateabr2-letter state abbreviation IDstreetFull street (number + name + suffix) 364 East ParkwaystreetnameStreet name ViewstreetnumberStreet number 364streetprefixDirectional prefix (N, E, SW) EaststreetsuffixStreet type (Ave, St, Blvd) ParkwaytimezoneTimezone name America/New_Yorktimezoneabv3-letter timezone abbreviation ESTtimezonefullFull timezone name Eastern Standard TimetimezoneoffsetUTC offset -5timezoneregionTimezone region AmericaunitBuilding unit (apt, suite) Apt 204zipPostal code 83201
Airline# Pattern Description Example airlineaircrafttypeAircraft category Narrow-bodyairlineairplaneAircraft model Boeing 737airlineairportAirport name Heathrow AirportairlineairportiataIATA airport code LHRairlineflightnumberFlight number BA142airlinerecordlocatorBooking reference XJDF42airlineseatSeat assignment 14A
Animals# Pattern Description Example animalAnimal name LionanimaltypeAnimal type (mammal, bird, etc.) mammalbirdBird species EaglecatCat breed SiamesedogDog breed LabradorfarmanimalFarm animal CowpetnamePet name Buddy
Color# Pattern Description Example colorColor name MediumSlateBluehexcolorHex color code #1a2b3cnicecolorsCurated color palette [#e8d5b7, #0e2430, ...]rgbcolorRGB color values [52, 152, 219]safecolorWeb-safe color name fuchsia
Company# Pattern Description Example blurbCompany description We provide scalable...bsBusiness buzzword phrase synergize scalable mindsharebuzzwordBusiness buzzword synergizecompanyCompany name Acme CorpcompanysuffixCompany suffix (Inc., LLC) Inc.jobJob details {company: Google, title: Contractor, descriptor: District, level: Assurance}jobdescriptorJob descriptor SeniorjoblevelJob level ManagerjobtitleJob title Software EngineersloganCompany slogan Think different.
Pattern Description Example emailEmail address markusmoen@pagac.netphonePhone number 6136459211phoneformattedFormatted phone number (613) 645-9211usernameAccount username markus.moen
Data Structures# Pattern Description Example csv:,,10CSV rows (delimiter, row count) name,email\nAlice,...fixed_width:10Fixed-width format Alice ...json:object,10JSON document (type, field count) {"name": "..."}mapRandom key-value map {interest: 5418, only: 2991258, fly: {shall: 1188343}}sql:,10SQL INSERT statements INSERT INTO ...svg:500,500SVG image <svg>...</svg>template:Template-driven text (from template) xml:single,xml,record,10XML document <record>...</record>
Date & Time# Pattern Description Example date:RFC3339Date in specified format 2023-07-15T14:32:07Zdaterange:2020-01-01,2025-12-31,yyyy-MM-ddDate in range with format 2023-07-15dayDay of month 15futuredateDate in the future 2027-03-21T10:00:00ZhourHour (0-23) 14minuteMinute (0-59) 32monthMonth number (1-12) 7monthstringMonth name JulynanosecondNanosecond 196519854pastdateDate in the past 2019-11-05T08:30:00ZsecondSecond (0-59) 7time:HH:mm:ssTime in format (default HH:mm:ss) 14:32:07timerange:08:00:00,17:00:00,HH:mm:ssTime in range with format 12:45:23weekdayWeekday name WednesdayyearYear 2023
Emoji# Pattern Description Example emojiRandom emoji 🎉emojialiasEmoji alias keyword :tada:emojianimalAnimal emoji 🐕emojicategoryEmoji category Smileys & EmotionemojiclothingClothing emoji 👗emojicostumeCostume/fantasy emoji 🧛emojielectronicsElectronics emoji 📱emojifaceFace/smiley emoji 😊emojiflagFlag emoji 🇺🇸emojifoodFood emoji 🍕emojigameGame emoji 🎮emojigestureGesture emoji 🤷emojihandHand emoji 👍emojijobJob/role emoji 👨🔬emojilandmarkLandmark emoji 🗽emojimusicMusic emoji 🎸emojipersonPerson emoji 👩emojiplantPlant emoji 🌻emojisentence:3Sentence with emojis (N emojis) I am 😊 and 🎉 today 🌟emojisportSport emoji ⚽emojitagEmoji tag happyemojitoolsTools emoji 🔧emojivehicleVehicle emoji 🚗emojiweatherWeather emoji ☀️
Entertainment# Pattern Description Example bookBook details {title: Sons and Lovers, author: James Joyce, genre: Saga}bookauthorBook author F. Scott FitzgeraldbookgenreBook genre FictionbooktitleBook title The Great GatsbycelebrityactorCelebrity actor Tom HankscelebritybusinessBusiness celebrity Elon MuskcelebritysportSports celebrity Serena WilliamsgamertagGaming username xX_Slayer_XxhobbyHobby or pastime PhotographymovieMovie details {name: Sherlock Jr., genre: Music}moviegenreMovie genre Sci-FimovienameMovie title The MatrixsongSong details {name: Agora Hills, artist: Olivia Newton-John, genre: Country}songartistSong artist QueensonggenreSong genre RocksongnameSong title Bohemian Rhapsody
Error Messages# Pattern Description Example errorError message unexpected EOFerrordatabaseDatabase error connection refusederrorgrpcgRPC error deadline exceedederrorhttpHTTP error 404 Not FounderrorhttpclientHTTP client error timeout awaiting...errorhttpserverHTTP server error 502 Bad GatewayerrorobjectError object {code: 500, message: service unavailable}errorruntimeRuntime error index out of boundserrorvalidationValidation error field required
Finance# Pattern Description Example achaccountACH bank account number 586981958265achrouting9-digit ACH routing number 071000013banknameBank name ChasebanktypeBank type CommercialbitcoinaddressBitcoin address 1A1zP1eP5QGefi2D...bitcoinprivatekeyBitcoin private key 5HueCGU8rMjxEXx...creditcardFull credit card details {type: UnionPay, number: 6376121963702920, exp: 10/29, cvv: 505}creditcardcvvCredit card CVV 513creditcardexpCredit card expiry 02/28creditcardnumberCredit card number (default: any type) 4111111111111111creditcardtypeCredit card type VisacurrencyCurrency details {short: ZAR, long: South Africa Rand}currencylongFull currency name United States Dollarcurrencyshort3-letter currency code USDcusipCUSIP security identifier 38259P508einEmployer Identification Number 12-3456789isinISIN security identifier US38259P5081price:0,1000Price in range (default 0-1000) 42.99
Food & Drink# Pattern Description Example beeralcoholBeer alcohol content 5.2%beerblgBeer gravity (BLG) 12.5beerhopBeer hop variety CascadebeeribuBeer bitterness (IBU) 40beermaltBeer malt type Pale AlebeernameBeer name DuvelbeerstyleBeer style IPAbeeryeastBeer yeast strain Safale US-05breakfastBreakfast food Scrambled eggsdessertDessert item Chocolate cakedinnerDinner food Grilled salmondrinkDrink LemonadefruitFruit ApplelunchLunch food Caesar saladsnackSnack item Trail mixvegetableVegetable Broccoli
Grammar# Pattern Description Example adjectiveGeneral adjective brightadjectivedemonstrativeDemonstrative adjective (this, that) thisadjectivedescriptiveDescriptive adjective beautifuladjectiveindefiniteIndefinite adjective someadjectiveinterrogativeInterrogative adjective whichadjectivepossessivePossessive adjective ouradjectiveproperProper adjective AmericanadjectivequantitativeQuantitative adjective severaladverbGeneral adverb quicklyadverbdegreeDegree adverb veryadverbfrequencydefiniteDefinite frequency adverb dailyadverbfrequencyindefiniteIndefinite frequency adverb oftenadverbmannerManner adverb carefullyadverbplacePlace adverb hereadverbtimedefiniteDefinite time adverb yesterdayadverbtimeindefiniteIndefinite time adverb soonconnectiveConnective word howeverconnectivecasualCausal connective becauseconnectivecomparativeComparative connective similarlyconnectivecomplaintComplaint connective unfortunatelyconnectiveexamplifyExample connective for instanceconnectivelistingListing connective firstlyconnectivetimeTime connective meanwhileinterjectionInterjection wownounGeneral noun tablenounabstractAbstract noun freedomnouncollectiveanimalAnimal collective noun flocknouncollectivepeoplePeople collective noun crowdnouncollectivethingThing collective noun bundlenouncommonCommon noun booknounconcreteConcrete noun chairnouncountableCountable noun applenoundeterminerNoun determiner thenounproperProper noun LondonnoununcountableUncountable noun waterprepositionGeneral preposition withprepositioncompoundCompound preposition in front ofprepositiondoubleDouble preposition out ofprepositionsimpleSimple preposition atpronounGeneral pronoun shepronoundemonstrativeDemonstrative pronoun thesepronounindefiniteIndefinite pronoun someonepronouninterrogativeInterrogative pronoun whopronounobjectObject pronoun himpronounpersonalPersonal pronoun IpronounpossessivePossessive pronoun minepronounreflectiveReflexive pronoun myselfpronounrelativeRelative pronoun whichverbGeneral verb runverbactionAction verb jumpverbhelpingHelping verb wouldverbintransitiveIntransitive verb sleepverblinkingLinking verb seemverbtransitiveTransitive verb carry
Hacker# Pattern Description Example hackerabbreviationHacker abbreviation SQLhackeradjectiveHacker adjective back-endhackeringverbHacker -ing verb hackinghackernounHacker noun firewallhackerphraseHacker phrase Use the neural TCP...hackerverbHacker verb parse
Internet# Pattern Description Example apiuseragentAPI client user agent curl/7.68.0chromeuseragentChrome user agent Mozilla/5.0 ... Chrome/...domainnameDomain name example.comdomainsuffixDomain suffix .comfirefoxuseragentFirefox user agent Mozilla/5.0 ... Firefox/...httpmethodHTTP method GEThttpstatuscodeHTTP status code 404httpstatuscodesimpleCommon HTTP status code 200httpversionHTTP version 1.1inputnameHTML input element name first_nameipv4addressIPv4 address 192.168.1.42ipv6addressIPv6 address 2001:db8::1macaddressMAC address 00:1A:2B:3C:4D:5EoperauseragentOpera user agent Mozilla/5.0 ... OPR/...safariuseragentSafari user agent Mozilla/5.0 ... Safari/...urlWeb URL https://www.example.com/pathurlslug:3URL-safe slug (N words, default 3) modern-web-designuseragentBrowser user agent string Mozilla/5.0 ...
Language# Pattern Description Example languageLanguage name EnglishlanguageabbreviationLanguage abbreviation enlanguagebcpBCP 47 language tag en-USprogramminglanguageProgramming language Go
Minecraft# Pattern Description Example minecraftanimalMinecraft animal CowminecraftarmorpartArmor piece ChestplateminecraftarmortierArmor tier DiamondminecraftbiomeMinecraft biome PlainsminecraftdyeMinecraft dye color RedminecraftfoodMinecraft food BreadminecraftmobbossBoss mob Ender DragonminecraftmobhostileHostile mob CreeperminecraftmobneutralNeutral mob EndermanminecraftmobpassivePassive mob SheepminecraftoreMinecraft ore DiamondminecrafttoolMinecraft tool PickaxeminecraftvillagerjobVillager job LibrarianminecraftvillagerlevelVillager level JourneymanminecraftvillagerstationVillager station LecternminecraftweaponMinecraft weapon SwordminecraftweatherMinecraft weather RainminecraftwoodMinecraft wood type Oak
Miscellaneous# Pattern Description Example email_textEmail message body Dear Sir/Madam...imagejpeg:500,500Random JPEG image (W×H) (binary image data) imagepng:500,500Random PNG image (W×H) (binary image data) loglevelLog severity level errorpassword:true,true,true,true,false,12Password (lower, upper, numeric, special, space, length) aB3$kL9mPq2xrandomint:1,2,3,4,5Random pick from int list 3randomstring:foo,bar,bazRandom pick from string list barrandomuint:10,20,30Random pick from uint list 20shuffleints:1,2,3,4,5Shuffle int list [3,1,5,2,4]shufflestrings:foo,bar,bazShuffle string list [baz,foo,bar]teams:,Split people into teams (team assignments) weighted:,Weighted random selection (selected value)
Numbers# Pattern Description Example booltrue or false truedice:2,[6,6]Dice roll (count, sides per die) [4, 2]digitSingle digit (0-9) 7digitn:6String of N digits 482910flipacoinCoin toss Headsfloat3232-bit float 3.14float32range:1,1032-bit float in range 7.23float6464-bit float 3.141592653float64range:0,164-bit float in range 0.7312hexuint:8Hex unsigned integer (N hex chars) 4a3f2b1cintRandom signed integer 8294723int8Signed 8-bit integer (−128 to 127) 42int16Signed 16-bit integer 8294int32Signed 32-bit integer 829472389int64Signed 64-bit integer 8294723891234intn:100Integer in [0, N) 73intrange:1,100Signed integer in range 67number:1,100Integer in range (default full int32 range) 42uintUnsigned integer 4294967uint8Unsigned 8-bit integer (0-255) 200uint16Unsigned 16-bit integer (0-65535) 50000uint32Unsigned 32-bit integer 2948293uint64Unsigned 64-bit integer 394857239482uintn:100Unsigned integer in [0, N) 42uintrange:0,1000Unsigned integer in range 512
Person# Pattern Description Example ageAge in years 32bioRandom biography I'm a developer from NY...ethnicityCultural or ethnic background CaucasianfirstnameGiven name MarkusgenderGender classification malelastnameFamily name MoenmiddlenameMiddle name JamesnameFull name (first and last) Markus MoennameprefixTitle or honorific (Mr., Mrs., Dr.) Mr.namesuffixSuffix (Jr., Sr., III) Jr.personFull personal details (name, contact, etc.) {first_name: Jessica, last_name: Hills, gender: female, age: 51, ssn: 961445393, ...}ssnUS Social Security Number 296-28-1925
Product# Pattern Description Example productProduct details {name: Water Dispenser, price: 91.59, material: cardboard, upc: 058601249007, ...}productaudienceTarget audience ProfessionalsproductbenefitKey product benefit Time-savingproductcategoryProduct category ElectronicsproductdescriptionProduct description High-quality wireless...productdimensionProduct dimensions 10x5x3 inchesproductfeatureProduct feature WaterproofproductisbnISBN identifier 978-3-16-148410-0productmaterialProduct material Stainless SteelproductnameProduct name Ergonomic KeyboardproductsuffixProduct model suffix ProproductupcUPC barcode 012345678905productusecaseProduct use case Office productivity
School# Pattern Description Example schoolSchool name Lincoln High School
Pattern Description Example socialmediaSocial media handle/URL @johndoe
String Manipulation# Pattern Description Example generate:{firstname} {lastname}Generate from template Alice SmithidShort URL-safe base32 identifier 01hzxq5v8klexify:???Replace ? with random letters kqbnumerify:###Replace # with random digits 482regex:[A-Z]{3}-[0-9]{4}String matching regex ABK-7291uuidRFC 4122 v4 UUID 550e8400-e29b-41d4-a716-446655440000
Text# Pattern Description Example commentComment or remark This is great work!hipsterparagraph:2,5,1,\nHipster paragraph (multi-sentence hipster text) hipstersentence:5Hipster sentence (N words) Artisan cold-pressed vegan...hipsterwordHipster vocabulary word artisanletterSingle ASCII letter glettern:8String of N letters abcqwzmlloremipsumparagraph:2,5,1,\nLorem Ipsum paragraph (multi-sentence Lorem Ipsum) loremipsumsentence:5Lorem Ipsum sentence (N words) Lorem ipsum dolor sit amet.loremipsumwordLorem Ipsum word loremmarkdownMarkdown-formatted text (formatted markdown) paragraph:3,5,12,\nParagraph (sentences, words, paragraphs, separator) (multi-sentence text) phraseShort phrase a quiet afternoonphraseadverbAdverb phrase very carefullyphrasenounNoun phrase the old housephraseprepositionPrepositional phrase in the gardenphraseverbVerb phrase runs quicklyquestionQuestion sentence Where did you go?quoteQuoted text "To be or not to be"sentence:5Sentence with N words (default 5) The quick brown fox jumped.vowelSingle vowel ewordRandom word themselves
Vehicle# Pattern Description Example carCar details {type: Passenger car heavy, fuel: Ethanol, transmission: Automatic, brand: Alfa Romeo, model: Lancer, year: 2014}carfueltypeFuel type ElectriccarmakerCar manufacturer ToyotacarmodelCar model CamrycartransmissiontypeTransmission type AutomaticcartypeCar type Sedan