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
16
FluentValidation.AspNetCore
AspNetCore integration for FluentValidation
17
FluentValidation.AspNetCore
AspNetCore integration for FluentValidation
18
FluentValidation.DependencyInjectionExtensions
Dependency injection extensions for FluentValidation
18

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