NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
NuGet · #56 most downloaded on NuGet
A validation library for .NET that uses a fluent interface to construct strongly-typed validation rules.
Last release 9 months ago
03 Dec 2025
Ships fairly regularly
a new release about every 2 months
Nearly every release is documented
notes for 58 of the last 60 stable releases
15 versions withdrawn
withdrawn after publishing
127 years old
191 releases · first in 1900
Nothing published for this version
Fix one of the inheritance validator overloads not working correctly
Fix one of the inheritance validator overloads not working correctly (#1528)
Add non-generic Add method to inheritance validator. Updates to Persian translations (#1513) Added Bengali translations
Add non-generic Add method to inheritance validator. Updates to Persian translations (#1513) Added Bengali translations (#1517)
One column per quarter.
Add inheritance validator (#1237) Performance improvements.
Add inheritance validator (#1237) Performance improvements.
Nothing published for this version
Fix an issue with IncludeRulesNotInRuleSet not working correctly
Fix an issue with IncludeRulesNotInRuleSet not working correctly (#1493)
Make the ValidationContext.ThrowOnFailures getter public.
Make the ValidationContext.ThrowOnFailures getter public.
Update StopOnFirstFailure deprecation message.
Update StopOnFirstFailure deprecation message.
Nothing published for this version
Fix assembly version was still 8.
Fix assembly version was still 8.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Fix CollectionIndex placeholder not working with async workflow.
Fix CollectionIndex placeholder not working with async workflow.
Add explicit netcoreapp3.1 target to ASP.NET Core integration.
Add explicit netcoreapp3.1 target to ASP.NET Core integration.
Add support for ASP.NET Core 3.1 Fixed issue with property indexers being incorrectly stripped out when using test extensions. AddToModelState no long
Add support for ASP.NET Core 3.1 Fixed issue with property indexers being incorrectly stripped out when using test extensions. AddToModelState no longer includes a dot if PropertyName is null
Ensure lazily loaded calls to WithMessage can be used for client-side validation, provided they don't attempt to access model properties from inside t
Ensure lazily loaded calls to WithMessage can be used for client-side validation, provided they don't attempt to access model properties from inside the delegate (eg when using IStringLocalizer). Fix issue where OnFailure didn't work properly when invoked on validators with conditions.
Add ASP.NET Core-compatible version of the email address validator. Simplify the advanced testhelper syntax. Add support for ASP.NET Core 3. Add suppo
Add ASP.NET Core-compatible version of the email address validator. Simplify the advanced testhelper syntax. Add support for ASP.NET Core 3. Add support for defining child rules inline. ValidatorDescriptor now has consistent handling of model-level rules. RuleForEach can now access collection index in error message with {CollectionIndex} placeholder. Welsh language translations of default error messages. Hungrian language translations of default error messages. Indonesian language translations of default error messages. Using RuleForEach combined with When is now more intuitive. Fixed order of rule execution when using async validation.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Added simplified version of several messages across all translations to aid with ASP.NET Clientside validation. New enum validator for string properti
Added simplified version of several messages across all translations to aid with ASP.NET Clientside validation. New enum validator for string properties.
Improved how calls to When/Unless are handled internally. DelegatingValidator is now marked as deprecated. Improvements to Croatian language translati…
Fix issue in ASP.NET Core integration with GetServiceProvider not working correctly when invoked against a CustomContext/MessageBuilderContext. Improved how LanguageStringSource works with error-code overrides. Fix thread-safety issue with use of PropertyValidatorOptions.Empty (now removed). Improved how calls to When/Unless are handled internally. DelegatingValidator is now marked as deprecated. Improvements to Croatian language translations. Improvements to Georgian language translations. Resolved subtle bug where top-level WhenAsync wouldn't work correctly when wrapping a top-level call to When.
Fix issue with WebApi integration where DataAnnotations validation could generate duplicate messages when used in the same project as FluentValidation
Fix issue with WebApi integration where DataAnnotations validation could generate duplicate messages when used in the same project as FluentValidation.
Fix typo in FluentValidation.DependencyInjectionExtensions package name.
Fix typo in FluentValidation.DependencyInjectionExtensions package name.
Resolved issue using InjectValidator with RuleForEach. Add support for a default IValidatorInterceptor to be registered with the ASP.NET Core Service
Resolved issue using InjectValidator with RuleForEach. Add support for a default IValidatorInterceptor to be registered with the ASP.NET Core Service Provider. Added "Without" test extensions for consistency with existing "With" text extensions.
Add extensions for injecting child validators using the ASP.NET Core Service Provider. WithLocalizedMessage is deprecated. Use the overload of WithMes…
Add extensions for injecting child validators using the ASP.NET Core Service Provider. WithLocalizedMessage is deprecated. Use the overload of WithMessage that takes a Func instead. Implement RuleFor(...).ForEach(...) as an alternative to RuleForEach
Resolved issue where clientside validation was incorrectly generating metadata for rules with shared conditions. ScalePrecisionValidator now has a pub
Resolved issue where clientside validation was incorrectly generating metadata for rules with shared conditions. ScalePrecisionValidator now has a public method in the fluent interface. Fix placeholder names in ScalePrecisionValidator for consistency. Updates to Portuguese (Brazil) translations.
Fix the same issue from 8.1.1 but for async conditions. Fix issue where shared When/Unless conditions didn't execute correctly when used with RuleForE
Fix the same issue from 8.1.1 but for async conditions. Fix issue where shared When/Unless conditions didn't execute correctly when used with RuleForEach.
Added RuleSetsExecuted property to ValidationResult. Fix issue with shared condition cache incorrectly caching when used with RuleForEach.
Added RuleSetsExecuted property to ValidationResult. Fix issue with shared condition cache incorrectly caching when used with RuleForEach.
Added format support for message placeholders. Added support for overriding indexers for collection rules. Allow ErrorCode to be used to override loca
Added format support for message placeholders. Added support for overriding indexers for collection rules. Allow ErrorCode to be used to override localization key in the Language Manager. Additional error details are now shown in the ShouldNotHaveValidationErrorFor test extension. Conditions defined with root-level When/WhenAsync/Unless/UnlessAsync are now only executed once (instead of once for each rule). Support Otherwise method chained from root-level When/WhenAsync/Unless/UnlessAsync. Minor wording changes to default English error messages. Added Skip property to MVC5's CustomizeValidatorAttribute to bring parity with AspNetCore and WebApi integration. Japanese translation of the default error messages. Remove type constraint on the OverridePropertyName overload that takes an expression.
Nothing published for this version
Nothing published for this version
Fix clientside property comparison validation adaptor in ASP.NET Core integration.
Fix clientside property comparison validation adaptor in ASP.NET Core integration.
Added Greek language translation. Resolved an issue where Cascade and Transform couldn't be used with RuleForEach
Added Greek language translation. Resolved an issue where Cascade and Transform couldn't be used with RuleForEach
IStringSource.GetString now takes a context. Major cleanup of asynchronous validation workflow. Deprecate SetCollectionValidator in favour of RuleForE…
Support validating only specific properties by path. Allow specifying a ruleset with SetValidator for complex properties. Introduce PropertyValidatorOptions in order to clean up the IPropretyValidator interface. Moved the AttributedValidatorFactory into a separate package. IStringSource.GetString now takes a context. Major cleanup of asynchronous validation workflow. Deprecate SetCollectionValidator in favour of RuleForEach().SetValidator Remove the pre-7 version of Custom/CustomAsync. Removed deprecated localization system. Remove deprecated RemoveRule/ReplaceRule/ClearRules methods.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Added Albanian language translations Added Chinese Traditional language translation Fix #858 ValidationTestExtension.When() incorrectly checks each fa
Added Albanian language translations Added Chinese Traditional language translation Fix #858 ValidationTestExtension.When() incorrectly checks each failure instead of all failures
Added AbstractValidator.PreValidate to allow immediate cancellation of validation.
Added AbstractValidator.PreValidate to allow immediate cancellation of validation.
Using [BindProperty] in AspNetCore now works when implicit child validation is disabled. ShouldHaveChildValidator now works when the child validator i
Using [BindProperty] in AspNetCore now works when implicit child validation is disabled. ShouldHaveChildValidator now works when the child validator is inside a DependentRules block. Test helpers are now compatible with custom property name resolvers set using ValidatorOptions.PropertyNameResolver. Switched to embedded debug symbols.
Fixed a regression where calling ValidateAsync with RuleForEach would no longer execute tasks sequentially (#799).
Fixed a regression where calling ValidateAsync with RuleForEach would no longer execute tasks sequentially (#799).
Added support for RuleForEach to the testing extensions (#238). Fixed a regression where calling ValidateAsync with RuleForEach could cause a deadlock
Added support for RuleForEach to the testing extensions (#238). Fixed a regression where calling ValidateAsync with RuleForEach could cause a deadlock (#799). Added ToString overrides on ValidationResult to generate a string representation of all errors (#778). Updated logos thanks to Dylan Beattie (#780).
Resolved an issue where ValidateAsync was called on child validators when the root validator was invoked synchronously.
Resolved an issue where ValidateAsync was called on child validators when the root validator was invoked synchronously.
Nothing published for this version
Nothing published for this version
Support multiple rulesets on a rule. Make setters on ValidationFailure's properties public to allow for easier deserialization. Additional overload fo
Support multiple rulesets on a rule. Make setters on ValidationFailure's properties public to allow for easier deserialization. Additional overload for OverridePropertyName that takes an expression. Add overload of Include that lazily creates the inner validator. Allow replacing the default Error Code resolution process
Support CustomizeValidatorAttribute in WebApi integration Resolved issues with referencing FluentValidation from legacy PCLs.
Support CustomizeValidatorAttribute in WebApi integration Resolved issues with referencing FluentValidation from legacy PCLs.
Nothing published for this version
Nothing published for this version
Resolved issue in AspNetCore integration where the change made in 7.3.3 meant that child collections were incorrectly skipped for DataAnnotations-base
Resolved issue in AspNetCore integration where the change made in 7.3.3 meant that child collections were incorrectly skipped for DataAnnotations-based validation, as well as FV
Your coding agent can read these notes before it upgrades. Set up the MCP server →