Hibernate Validator

5.3 series stable

Dynamic constraint payload, parameter relaxation, new api for programmatic constraint definition, new translations.


Java 6, 7 or 8
Bean Validation 1.1

Not compatible with your requirements? Have a look at the other series.

See also the Compatibility policy.


Documentation for this specific series can be accessed through the links below:


You can find more documentation for all series on the documentation page.

How to get it

Maven, Gradle...

Maven artifacts of Hibernate Validator are published to Maven Central and to the JBoss Maven repository. Refer to the Maven Getting Started guide on the JBoss Wiki for more information on how to configure the JBoss Maven repository.

You can find the Maven coordinates of all artifacts through the link below:

Maven artifacts

Below are the Maven coordinates of the main artifacts.

Core implementation
CDI integration
OSGi integration
Annotation processor

Zip archive

Direct download is available from SourceForge:

Download Zip archive

More information about specific releases (announcements, download links) can be found here.

Getting started

If you want to start using the library, please refer to the getting started guide:



If you need to upgrade from a previous series, please refer to the migration guide:


What's new

A detailed list of new features, improvements and fixes in this series can be found on our issue tracker.

Dynamic payloads for constraints

Hibernate Validator 5.3 allows you to enrich custom constraint violations with additional context data.

Code examining constraint violations can access and interpret this data in a safer way than by parsing string-based constraint violation messages.

You can find more information about this feature in the 5.3.0.Alpha1 release announcement.

Relaxation of requirements for method validation in class hierarchies

The Bean Validation specification defines a set of rules which apply when defining constraints on methods within class hierarchies.

As per specification a Bean Validation provider is allowed to relax these preconditions.

Starting with 5.3, it is now possible to do so as explained in our documentation.

Programmatic API improvements

Until now, it was only possible to alter the list of ConstraintValidator of a given constraint via the XML configuration. 5.3 brings the ability to do it via the programmatic API.

JDK 9 support

5.3 is the first version compatible with JDK 9.

Other improvements

  • Arabic, Russian and Slovak translations

Releases in this series



dynamic constraint payload, parameter relaxation, new api for programmatic constraint definition, new translations


Maven artifacts Download Resolved issues Release announcement



Back to top