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
19
FluentValidation.AspNetCore
AspNetCore integration for FluentValidation
20
FluentValidation.AspNetCore
AspNetCore integration for FluentValidation
21
FluentValidation.AspNetCore
AspNetCore integration for FluentValidation
22
FluentValidation.AspNetCore
AspNetCore integration for FluentValidation
24
FluentValidation.DependencyInjectionExtensions
Dependency injection extensions for FluentValidation
21

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