Bogus 7.1.1-beta-1

A simple and sane data generator for populating objects that supports different locales. A delightful port of the famed faker.js and inspired by FluentValidation. Use it to create and load databases and UIs with mockup data. Get started by using Faker class or a DataSet directly.

No packages depend on Bogus.

v7.1.1

  • Roll-up Release for .NET Framework since last non-beta release.
  • CoreCLR users please continue using latest beta release until CoreCLR is RTM.

v7.1.1-beta-1

  • Locale update
  • Date.Recent(0) generates random times for current date between midnight and now.
  • New System data set for generating fake file names and mime-types.
  • Added Date.Timespan for random timespan values.
  • Added System.Semver for random semantic versions.
  • Added System.Version for random System.Version objects.
  • Added Internet.ExampleEmail for simple @example.com email generation.
  • Added Finance.BitcoinAddress for random bitcoin addresses.
  • BREAKING: Fake "seeded" data generated by Bogus may be different from previous versions.
  • WARN: Address.City may have changed in some random seeds

v6.1.1

  • Roll-up Release for .NET Framework since last non-beta release.
  • CoreCLR users please continue using latest beta release until CoreCLR is RTM.

v6.1.1-beta-1

  • Fixed index out of bounds bug in faker.Random.Word().
  • Commerce.Department output may have changed as a result of this fix.

v5.1.1-beta-3

  • Removed RuleFor(x = x.Prop, constantValue), was confusing the API.
  • Added 0-arity RuleFor(x = x.Prop, () => someValue)

v5.1.1-beta-2

  • Make f.UniqueIndex as int for convenience.
  • Use generic RuleFor(x = x.Prop, constantValue).

v5.1.1-beta-1

  • New RuleFor(x = x.Prop, constantValue)
  • Support for Hashids.net: RuleFor(x = x.Id, f = f.Hashids.Encode())
  • New f.UniqueIndex, useful for composing property values that require uniqueness.

v5.0.1

  • Roll-up Release for .NET Framework since v4.0.1.
  • CoreCLR users please continue using latest beta release until CoreCLR is RTM.

v5.0.1-beta-2

  • JvanderStad PR15: Lazy load Person. Avoids extra Seed.Next calls that may interfere with seeded content.
  • JvanderStad PR16: Better address generation. Respects locale address formats.
  • Added "dotnet5.4" moniker support.
  • BREAKING: Fake "seeded" data generated by Bogus may be different from previous versions.

v4.0.1

  • Roll-up Release for .NET Framework since v3.0.6.
  • CoreCLR users please continue using latest beta release until CoreCLR is RTM.

v4.0.1-beta-1

  • Bogus - Feature parity with faker.js.
  • System module added. Generate random file names and extensions.
  • Randomizer - Added Uuid().
  • Locales Updated: en_GB, sv, sk, de_CH, en.
  • Locales Added: id_ID, el, lv.
  • Prevent apostrophes in return value of Internet.DomainWords
  • Added more parameters for Image data set.
  • BREAKING API METHODS:
  • Lorem - Better API methods: Seeded tests based on "content" will fail due to upgrade.

v3.0.6

  • Roll-up Release for .NET Framework since v3.0.5.
  • CoreCLR users please continue using latest beta release until CoreCLR is RTM.

v3.0.6-beta-1

  • Issue #13: Fixed StrictMode to exclude private fields.
  • New Feature: Ignore property or field in StrictMode: Faker[Order].Ignore(o => o.OrderId).
  • CoreCLR users please continue using latest beta release until CoreCLR is RTM.

v3.0.5

  • Roll-up Release for .NET Framework since v3.0.4.
  • CoreCLR users please continue using latest beta release until CoreCLR is RTM.

v3.0.5-beta-4

  • Issue #13: StrictMode() now ignores read-only properties.
  • Newtonsoft.Json v8 compatibility.
  • CoreCLR users please continue using latest beta release until CoreCLR is RTM.

v3.0.5-beta-3

  • Issue #12: Make Bogus thread-safe on Generate() and DataSets. Avoids threading issues in test runners.
  • CoreCLR users please continue using latest beta release until CoreCLR is RTM.

v3.0.5-beta-2

  • CoreCLR support (CoreCLR users please continue using latest beta release until CoreCLR is RTM.).

v3.0.4

  • Issue 10: Make Bogus work with fields also, not just properties. Fixes LINQPad issues.

v3.0.3

  • PR 9: quantumplation - Fixed typo in Lorem.Sentance() -> Lorem.Sentence()

v3.0.2

  • Generate US: SSN - Social Security Numbers.
  • Generate Canada: SIN - Social Insurance Numbers.
  • Generate Brazil: Cadastro de Pessoas Fisicas - CPF Numbers.
  • Generate Finland: Henkilotunnus - Person ID numbers
  • Generate Denmark: Det Centrale Personregister - Person ID numbers.
  • Allow exclude values on Randomizer.Enum.
  • Randomizer.Replace accepts '*' replace with letter or digit.
  • Added Lorem.Letter(num).
  • Can switch locale on Name: f.Name["en"].LastName()

v3.0.1

  • Added debug symbols to symbolsource.org.
  • PR#6: Fixed lastname and empty list exception -salixzs
  • Switch to semantic versioning at par with FakerJS.

v3.0.0.4

  • Adding generators: Date.Month(), Date.Weekday()
  • Sentences using lexically correct "A foo bar."
  • Added Spanish Mexico (es_MX) locale.

v3.0.0.3

  • Issue #2: Use latest Newtonsoft.Json 7.0.0.0 -Mpdreamz

v3.0.0.2

  • Includes Ireland (English) locale.

v3.0.0.1

  • Migrated to new FakerJS datafile format. Build system uses gulp file to directly import FakerJS locales.
  • Faker.Parse() can now tokenize and replace handlebar formats.
  • Added Faker.Hacker and Faker.Company properties.
  • Added Custom separator on Lorem.Paragraph.
  • Added Canada (French) (fr_CA) locale.
  • Added Ukrainian (uk) locale.
  • Added Ireland (en_IE) locale.
  • Added Internet.Mac for mac addresses.
  • Support for Canadian post/zip codes.
  • Exposed Name.JobTitle, Name.JobDescriptor, Name.JobArea, Name.JobType
  • Exposed Address.CountryCode
  • Replace symbols in domain words so it generates output for all locales
  • Support for gender names, but only for locales that support it. Russian('ru') but not English('en').
  • Corrected abbreviation for Yukon to reflect its official abbreviation of "YT".

v2.1.5.2:

  • Fixed instantiating a Person in a non-US locale. -antongeorgiev

v2.1.5.1:

  • Added Georgian, Turkish, and Chinese (Taiwan) locales.
  • Added Name.JobTitle()
  • Added Internet.Url() and Internet.Protocol().
  • Sync'd up with faker.js v2.1.5.

v2.1.4.2:

  • Fixed bug in Faker.Person and Faker[T] that generates new person context after every new object.
  • Added support for .FinishWith() for post-processing that runs after all rules but before returning new instance.
  • Added Newtonsoft.Json as NuGet dependency.

v2.1.4.1:

  • Minor changes, mostly XML doc update and Person moved from DataSet to Bogus namespace.

v2.1.4.0:

  • Initial port from faker.js 2.1.4.

.NET Framework 4.0

DNX 4.5.1

DNXCore 5.0

.NETPlatform 5.4

Version Downloads Last updated
35.6.5 0 10/26/2025
35.6.4 0 12/11/2025
35.6.3 2 12/09/2025
35.6.2 0 12/09/2025
35.6.1 0 09/02/2024
35.6.0 0 07/19/2024
35.5.1 0 04/28/2024
35.5.0 1 12/09/2025
35.4.1 2 12/10/2025
35.4.0 0 01/14/2024
35.3.2 0 01/14/2024
35.3.1 0 01/13/2024
35.3.0 0 01/01/2024
35.2.0 1 12/09/2025
35.0.1 0 12/12/2023
34.0.2 0 03/27/2022
34.0.1 0 11/23/2021
33.1.1 1 12/12/2025
33.0.2 1 12/13/2025
33.0.1 0 02/07/2021
32.1.1 0 01/31/2021
32.0.2 2 12/09/2025
32.0.1 3 12/09/2025
31.0.3 1 12/09/2025
30.0.4 3 12/12/2025
30.0.1-beta-4 1 12/11/2025
30.0.1-beta-3 1 12/10/2025
30.0.1-beta-2 0 06/21/2020
30.0.1-beta-1 0 06/15/2020
29.0.2 1 12/12/2025
29.0.1 0 02/10/2020
28.4.4 2 12/09/2025
28.4.3 0 12/04/2019
28.4.2 0 11/30/2019
28.4.1 0 10/15/2019
28.3.2 0 10/04/2019
28.3.1 0 09/21/2019
28.2.1 1 12/09/2025
28.1.1 0 09/10/2019
28.0.3 1 12/09/2025
28.0.2 1 12/13/2025
28.0.1 1 12/13/2025
27.0.1 1 12/09/2025
26.0.2 0 03/22/2019
26.0.1 2 12/09/2025
25.0.4 2 12/13/2025
25.0.3 1 12/09/2025
25.0.2 2 12/10/2025
25.0.1 1 12/09/2025
24.3.1 0 11/03/2018
24.3.0 1 12/09/2025
24.2.0 0 09/27/2018
23.0.2 0 08/13/2018
22.3.2 1 12/13/2025
22.3.1 0 07/05/2018
22.2.1 0 06/29/2018
22.1.4 0 06/26/2018
22.1.3 0 06/14/2018
22.1.2 0 05/29/2018
22.1.1 1 12/09/2025
22.0.9 1 12/13/2025
22.0.8 2 12/09/2025
22.0.7 1 12/14/2025
22.0.6 0 03/29/2018
22.0.5 1 12/14/2025
22.0.3 1 12/09/2025
22.0.2 0 01/06/2018
22.0.1 2 12/09/2025
21.0.5 1 12/09/2025
21.0.4 0 12/13/2017
21.0.2 0 12/08/2017
20.0.2 0 11/06/2017
20.0.1 0 11/05/2017
19.0.2 2 12/12/2025
18.0.2 0 09/14/2017
18.0.1 0 09/13/2017
17.0.1 0 08/25/2017
16.0.3 0 08/24/2017
16.0.2 3 12/09/2025
15.0.7 1 12/09/2025
15.0.6 1 12/12/2025
15.0.5 1 12/14/2025
15.0.3 0 05/07/2017
15.0.1 1 12/14/2025
12.0.1 0 03/27/2017
11.0.5 0 03/20/2017
11.0.4 1 12/13/2025
11.0.3 1 12/09/2025
11.0.2 0 02/23/2017
11.0.1 0 02/21/2017
10.0.1 0 02/18/2017
9.0.2 0 01/19/2017
9.0.1 0 01/18/2017
8.0.4 0 01/17/2017
8.0.3 0 12/20/2016
8.0.2 0 12/07/2016
8.0.1 1 12/13/2025
8.0.1-beta-1 0 10/22/2016
7.1.7 1 12/09/2025
7.1.6 1 12/09/2025
7.1.5 2 12/10/2025
7.1.4 1 12/09/2025
7.1.3 1 12/12/2025
7.1.3-beta-1 0 05/20/2016
7.1.2 0 05/16/2016
7.1.2-beta-1 0 05/16/2016
7.1.1 1 12/09/2025
7.1.1-beta-1 1 12/09/2025
6.1.1 1 12/10/2025
6.1.1-beta-1 0 03/29/2016
5.1.1-beta-3 0 03/23/2016
5.1.1-beta-2 1 12/09/2025
5.1.1-beta-1 0 03/21/2016
5.0.1 0 02/25/2016
5.0.1-beta-2 0 02/25/2016
4.0.1 1 12/09/2025
4.0.1-beta-1 0 02/16/2016
3.0.6 1 12/14/2025
3.0.6-beta-1 0 01/21/2016
3.0.5 1 12/13/2025
3.0.5-beta-4 0 01/20/2016
3.0.5-beta-3 0 01/18/2016
3.0.5-beta-2 0 01/12/2016
3.0.4 1 12/09/2025
3.0.3 0 12/09/2015
3.0.2 2 12/09/2025
3.0.1 1 12/13/2025
3.0.0.3 0 07/21/2015
3.0.0.2 0 07/12/2015
3.0.0.1 0 07/12/2015
2.1.5.2 0 06/22/2015
2.1.5.1 0 06/11/2015
2.1.4.2 0 06/11/2015
2.1.4.1 0 06/10/2015
2.1.4 2 12/11/2025