FluentValidation 12.0.0-preview1

FluentValidation is validation library for .NET that uses a fluent interface and lambda expressions for building strongly-typed validation rules.

Supporting the project

If you use FluentValidation in a commercial project, please sponsor the project financially. FluentValidation is developed and supported by @JeremySkinner for free in his spare time and financial sponsorship helps keep the project going. You can sponsor the project via either GitHub sponsors or OpenCollective.

Example

With FluentValidation, you can define a class that inherits from AbstractValidator which contains the rules for a particular class. The example below shows how you could define rules for a Customer class, and then how to execute the validator.

using FluentValidation;

public class CustomerValidator: AbstractValidator<Customer> {
  public CustomerValidator() {
    RuleFor(x => x.Surname).NotEmpty();
    RuleFor(x => x.Forename).NotEmpty().WithMessage("Please specify a first name");
    RuleFor(x => x.Discount).NotEqual(0).When(x => x.HasDiscount);
    RuleFor(x => x.Address).Length(20, 250);
    RuleFor(x => x.Postcode).Must(BeAValidPostcode).WithMessage("Please specify a valid postcode");
  }

  private bool BeAValidPostcode(string postcode) {
    // custom postcode validating logic goes here
  }
}

var customer = new Customer();
var validator = new CustomerValidator();

// Execute the validator.
ValidationResult results = validator.Validate(customer);

// Inspect any validation failures.
bool success = results.IsValid;
List<ValidationFailure> failures = results.Errors;

Full Documentation

Full documentation can be found at https://docs.fluentvalidation.net

Release Notes and Change Log

Release notes can be found on GitHub.

Showing the top 20 packages that depend on FluentValidation.

Packages Downloads
FluentValidation.AspNetCore
AspNetCore integration for FluentValidation
18
FluentValidation.AspNetCore
AspNetCore integration for FluentValidation
19
FluentValidation.AspNetCore
AspNetCore integration for FluentValidation
20
FluentValidation.DependencyInjectionExtensions
Dependency injection extensions for FluentValidation
20

FluentValidation 12 is a major release. Please read the upgrade guide at https://docs.fluentvalidation.net/en/latest/upgrading-to-12.html

Full release notes can be found at https://github.com/FluentValidation/FluentValidation/releases

.NET 8.0

  • No dependencies.

Version Downloads Last updated
12.1.1 6 18.12.2025
12.1.0 11 09.11.2025
12.0.0 15 23.05.2025
12.0.0-preview1 17 12.01.2025
11.12.0 9 09.11.2025
11.11.0 20 02.12.2024
11.10.0 19 01.10.2024
11.9.2 19 12.01.2025
11.9.1 17 15.01.2025
11.9.0 21 10.01.2025
11.8.1 21 05.01.2025
11.8.0 16 15.01.2025
11.7.1 18 15.01.2025
11.7.0 19 08.01.2025
11.6.0 16 15.01.2025
11.5.2 18 08.01.2025
11.5.1 16 23.01.2025
11.5.0 19 05.01.2025
11.4.0 18 15.01.2025
11.3.0 16 09.01.2025
11.2.2 21 07.01.2025
11.2.1 17 15.01.2025
11.2.0 19 14.01.2025
11.1.1 15 07.01.2025
11.1.0 17 23.01.2025
11.0.3 15 12.01.2025
11.0.2 17 28.01.2025
11.0.1 15 12.01.2025
11.0.0 19 10.01.2025
10.4.0 16 15.01.2025
10.3.6 15 15.01.2025
10.3.5 16 15.01.2025
10.3.4 15 10.01.2025
10.3.3 16 15.01.2025
10.3.1 22 10.01.2025
10.3.0 17 12.01.2025
10.2.3 21 15.01.2025
10.2.2 17 15.01.2025
10.2.1 17 15.01.2025
10.2.0 16 15.01.2025
10.1.0 16 15.01.2025
10.0.4 18 15.01.2025
9.5.4 17 15.01.2025
9.5.3 17 15.01.2025
9.5.2 17 14.01.2025
9.5.1 24 10.01.2025
9.5.0 21 15.01.2025
9.4.0 20 10.01.2025
9.3.0 16 10.01.2025
9.3.0-preview3 15 10.01.2025
9.3.0-preview2 16 09.01.2025
9.3.0-preview1 18 19.02.2025
9.2.2 17 10.01.2025
9.2.1 16 09.01.2025
9.2.0 24 15.01.2025
9.1.3 16 15.01.2025
9.1.2 17 15.01.2025
9.1.1 19 10.01.2025
9.1.0 20 10.01.2025
9.0.1 19 14.01.2025
9.0.0-preview5 16 06.01.2025
9.0.0-preview4 18 07.01.2025
9.0.0-preview3 18 06.01.2025
9.0.0-preview2 20 07.01.2025
9.0.0-preview1 17 12.01.2025
8.6.3 19 15.01.2025
8.6.2 17 15.01.2025
8.6.1 18 15.01.2025
8.6.0 17 15.01.2025
8.5.1 18 15.01.2025
8.5.0 17 15.01.2025
8.5.0-preview5 20 10.01.2025
8.5.0-preview4 15 11.01.2025
8.5.0-preview3 16 10.01.2025
8.5.0-preview2 15 06.01.2025
8.5.0-preview1 17 10.01.2025
8.4.0 16 28.01.2025
8.3.0 16 10.01.2025
8.2.3 26 15.01.2025
8.2.2 17 05.01.2025
8.2.1 16 28.01.2025
8.2.0 17 15.01.2025
8.1.3 17 15.01.2025
8.1.2 15 12.01.2025
8.1.1 17 10.01.2025
8.1.0 16 14.01.2025
8.1.0-preview2 17 13.01.2025
8.1.0-preview1 17 23.01.2025
8.0.101 16 10.01.2025
8.0.100 21 15.01.2025
8.0.0 17 15.01.2025
8.0.0-rc1 16 10.01.2025
8.0.0-preview4 16 05.01.2025
8.0.0-preview3 19 07.01.2025
8.0.0-preview2 18 07.01.2025
7.6.105 17 15.01.2025
7.6.104 16 15.01.2025
7.6.103 17 15.01.2025
7.6.102 19 11.01.2025
7.6.101 20 15.01.2025
7.6.100 19 15.01.2025
7.6.0 19 12.01.2025
7.6.0-preview1 15 07.01.2025
7.5.2 16 10.01.2025
7.5.1 17 15.01.2025
7.5.0 17 15.01.2025
7.4.0 17 15.01.2025
7.3.4 20 10.01.2025
7.3.3 17 15.01.2025
7.3.2 18 15.01.2025
7.3.1 16 15.01.2025
7.3.0 17 15.01.2025
7.3.0-beta3 15 28.01.2025
7.3.0-beta2 16 28.01.2025
7.3.0-beta1 16 28.01.2025
7.2.1 18 09.01.2025
7.2.0 16 15.01.2025
7.2.0-beta3 18 28.01.2025
7.2.0-beta2 15 27.01.2025
7.2.0-beta1 16 28.01.2025
7.1.1 20 10.01.2025
7.1.0 21 15.01.2025
7.1.0-beta1 19 10.01.2025
7.0.3 17 15.01.2025
7.0.2 16 28.01.2025
7.0.1 20 10.01.2025
7.0.0 17 15.01.2025
7.0.0-beta3 23 13.01.2025
7.0.0-beta2 23 10.01.2025
7.0.0-beta1 17 15.01.2025
6.4.1 18 28.01.2025
6.4.1-beta1 15 28.01.2025
6.4.0 23 10.01.2025
6.4.0-rc4 18 10.01.2025
6.4.0-rc3 24 10.01.2025
6.4.0-rc2 18 10.01.2025
6.4.0-rc1 16 10.01.2025
6.4.0-beta9 17 10.01.2025
6.4.0-beta8 15 28.01.2025
6.4.0-beta7 16 07.01.2025
6.4.0-beta6 22 07.01.2025
6.4.0-beta5 16 28.01.2025
6.4.0-beta4 17 13.01.2025
6.4.0-beta3 16 28.01.2025
6.4.0-beta2 15 27.01.2025
6.4.0-beta10 15 07.01.2025
6.4.0-beta1 16 29.01.2025
6.3.4-alpha 16 10.01.2025
6.3.3-alpha 16 10.01.2025
6.2.1 17 28.01.2025
6.2.1-beta1 15 27.01.2025
6.2.0 16 28.01.2025
6.2.0-beta1 16 07.01.2025
6.1.0 20 07.01.2025
6.0.2 21 11.01.2025
6.0.1 16 24.01.2025
6.0.0 16 28.01.2025
5.6.2 18 10.01.2025
5.6.1 17 15.01.2025
5.5.0 16 15.01.2025
5.4.0 17 15.01.2025
5.3.0 17 15.01.2025
5.2.0 17 15.01.2025
5.1.0 20 10.01.2025
5.0.0.1 19 15.01.2025
4.0.0.1 17 10.01.2025
4.0.0 15 23.01.2025
3.4.6 18 14.01.2025
3.4.0 17 15.01.2025
3.3.1 18 15.01.2025
3.2.0 14 15.01.2025
3.1.0 20 10.01.2025
3.0.0.1 18 15.01.2025
3.0.0 17 15.01.2025
2.0.0 17 28.01.2025
1.3.0 19 10.01.2025