MapStruct 1.5.0.Final is out

I am very happy to announce the final release of MapStruct 1.5! This is our 5th major release since November 2015.

Besides bug fixes, the 1.5 release brings some new exicting features:

  • Support for mapping from Map<String, ???> to a bean
  • Conditional mapping
  • Support for subclass mapping
  • Support for Jakarta dependency injection

For more details checkout the individual release announcements for the Beta1, Beta2, RC1

What’s inside

This major release brings few big new features for MapStruct:

In total 110 issues have been fixed between the 1.4.0.Final and 1.5.0.Final release. It is again interesting to see that the number of fixed issues between the previous 1.3.0.Final and 1.4.0.Final release is similar.

What’s next

We currently have 2 larger PRs open with new features:

We would like this 2 issues to be the baseline of the next 1.6.0 Release and hopefully do the next release faster than the current one.


Like every final release, we like to release some statistics about the project. We are very proud and thankful to our growing community. It is really satisfying to see how everyone helps each other in our Gitter Room, on StackOverflow or in our GitHub Discussions. We currently have 5300+ stars and 100 contributors on GitHub. More than 30000 people are using our IntelliJ plugin.

Most impressive though are the download numbers we get from the Maven Central repo. As an example here are the numbers for the org.mapstruct:mapstruct-processor artifact:

The number of Downloads compared to the time we released 1.4.0.Final has been doubled.


Last but not least we would like to congratulate all the enthusiastic MapStruct contributors making this release possible. In alphabetic order this are all the contributors that contributed to the 1.5 release of Mapstruct:

Happy coding with MapStruct 1.5!!


You can fetch the new release from Maven Central using the following GAV coordinates:

Alternatively, you can get ZIP and TAR.GZ distribution bundles - containing all the JARs, documentation etc. - from GitHub.

If you run into any trouble or would like to report a bug, feature request or similar, use the following channels to get in touch:

comments powered by Disqus