NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
NuGet, #54 most downloaded on NuGet
A convention-based object-object mapper.
Latest stable
17.0.0
Last release 10 days ago
12 Nov 2026
Release timing varies
gaps range from 9 days to 13 months
Most releases are documented
notes for 40 of 52 stable releases
182 versions withdrawn
withdrawn after publishing
127 years old
238 releases · first in 1900
Drag across the ruler to compare, or tap a release to open it.
Target .NET 11 and drop .NET 8 and 9 by @jbogard in #4681
Full Changelog: v16.3.0...v17.0.0
This release fixes two denial-of-service vulnerabilities. In both, deeply nested input could bypass MaxDepth and exhaust the stack. The resulting Stac…
This release fixes two denial-of-service vulnerabilities. In both, deeply nested input could bypass MaxDepth and exhaust the stack. The resulting StackOverflowException can't be caught, so it ends the process. Please upgrade if your application maps untrusted, deeply nested data.
MaxDepth wasn't enforced when mapping through constructor parameters, including positional records. Thanks to @mcambria for the report.MaxDepth: derived maps, object and interface members, dictionary and dynamic sources, and recursive type converters.CVE IDs have been requested and will be added here once they're assigned.
MaxDepth can't limit now throws a catchable InsufficientExecutionStackException instead of crashing the process.Include / IncludeBase) now inherit MaxDepth and get the default limit of 64 for self-referential maps. If your polymorphic graphs legitimately go deeper, set MaxDepth explicitly.Condition on ForAllMembers, or any condition whose member parameter is object or a base type, now receives the source member value instead of the value converted to the destination type, when those types differ. This matches the documented contract. A null in a nullable source member is now seen as null rather than 0 or false (#4655).Fixed Context.Items are only available... exceptions with MaxDepth, which depended on registration or warmup order (#4651)
License keys get a 30-day renewal grace period, which logs a warning instead of an error (#4667)
Clearer license validation messages for malformed keys, client platforms and IdentityModel version mismatches (#4670)
Whitespace is stripped from license keys (#4663), and license validation is isolated from the host app's CryptoProviderFactory (#4674)
Full Changelog: v16.2.0...v16.3.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Enhance SECURITY.md with comprehensive security policy by @jbogard in #4633
Full Changelog: v15.1.1...v16.2.0
Better async handling of license validation; fixes #4612 by @jbogard in #4613
Fixed an issue where certain cyclic or self-referential object graphs could trigger uncontrolled recursion during mapping, potentially resulting in stack exhaustion and denial of service.
Applications that process untrusted or attacker-controlled object graphs through affected mapping paths may be impacted.
Users should upgrade to this release.
Security advisory: GHSA-rvv3-g6hj-g44x
Thanks to @skdishansachin for responsibly disclosing this issue.
Full Changelog: v16.1.0...v16.1.1
Add Debug and Release build configurations to slnx by @Copilot in #4590
Full Changelog: v16.0.0...v16.1.0
Fix release pipelines by @jbogard in #4583
Full Changelog: v15.1.0...v16.0.0
Nothing published for this version
This release fixes two denial-of-service vulnerabilities. In both, deeply nested input could bypass MaxDepth and exhaust the stack. The resulting Stac…
This release fixes two denial-of-service vulnerabilities. In both, deeply nested input could bypass MaxDepth and exhaust the stack. The resulting StackOverflowException can't be caught, so it ends the process. Please upgrade if your application maps untrusted, deeply nested data.
MaxDepth wasn't enforced when mapping through constructor parameters, including positional records. Thanks to @mcambria for the report.MaxDepth: derived maps, object and interface members, dictionary and dynamic sources, and recursive type converters.CVE IDs have been requested and will be added here once they're assigned.
MaxDepth can't limit now throws a catchable InsufficientExecutionStackException instead of crashing the process.Include / IncludeBase) now inherit MaxDepth and get the default limit of 64 for self-referential maps. If your polymorphic graphs legitimately go deeper, set MaxDepth explicitly.Context.Items are only available... exceptions with MaxDepth, which depended on registration or warmup order (#4651, backported in #4676)Full Changelog: v15.1.3...v15.1.4
Fix GHSA-rvv3-g6hj-g44x : default MaxDepth of 64 for self-referential types (15.x backport) by @jbogard in #4619
Fixed an issue where certain cyclic or self-referential object graphs could trigger uncontrolled recursion during mapping, potentially resulting in stack exhaustion and denial of service.
Applications that process untrusted or attacker-controlled object graphs through affected mapping paths may be impacted.
Users should upgrade to this release.
Security advisory: GHSA-rvv3-g6hj-g44x
Thanks to @skdishansachin for responsibly disclosing this issue.
Full Changelog: v15.1.0...v15.1.3
Warning This release was built from the wrong branch and is deprecated. The v15.1.2 tag was created on main instead of release/15.x , so this package…
Warning
This release was built from the wrong branch and is deprecated. The v15.1.2 tag was created on main instead of release/15.x, so this package contains 16.x code: it targets net10.0/net471 and depends on Microsoft.Extensions.* 10.0.0. See #4620.
net10.0/net471 targets or 16.x APIs, upgrade to 16.x instead.This version has been unlisted and deprecated on NuGet. Existing restores of this exact version still work.
Fixed an issue where certain cyclic or self-referential object graphs could trigger uncontrolled recursion during mapping, potentially resulting in stack exhaustion and denial of service.
Applications that process untrusted or attacker-controlled object graphs through affected mapping paths may be impacted.
Users should upgrade to this release.
Security advisory: GHSA-rvv3-g6hj-g44x
Thanks to @skdishansachin for responsibly disclosing this issue.
Full Changelog: v16.1.1...v15.1.2
Warning This release was built from the wrong branch and is deprecated. The v15.1.1 tag was created on main instead of release/15.x , so this package…
Warning
This release was built from the wrong branch and is deprecated. The v15.1.1 tag was created on main instead of release/15.x, so this package contains 16.x code: it targets net10.0/net471 and depends on Microsoft.Extensions.* 10.0.0. See #4620.
net10.0/net471 targets or 16.x APIs, upgrade to 16.x instead.This version has been unlisted and deprecated on NuGet. Existing restores of this exact version still work.
Fixed an issue where certain cyclic or self-referential object graphs could trigger uncontrolled recursion during mapping, potentially resulting in stack exhaustion and denial of service.
Applications that process untrusted or attacker-controlled object graphs through affected mapping paths may be impacted.
Users should upgrade to this release.
Security advisory: GHSA-rvv3-g6hj-g44x
Thanks to @skdishansachin for responsibly disclosing this issue.
Full Changelog: v16.1.1...v15.1.1
remove Microsoft.SourceLink.GitHub by @SimonCropp in https://github.com/LuckyPennySoftware/AutoMapper/pull/4555
Full Changelog: https://github.com/LuckyPennySoftware/AutoMapper/compare/v15.0.1...v15.1.0
Because of this, the 15.0.0 will be delisted because of the breaking changes there.
Full Changelog: https://github.com/LuckyPennySoftware/AutoMapper/compare/v15.0.0...v15.0.1
This release supersedes the 15.0.0 release, reverting behavior and overloads so that the AddAutoMapper overloads separate the "scanning for maps" from the "scanning for dependencies". Unfortunately it's not really possible to combine these two together.
This also fixes a critical bug in #4545 that does not work with .NET 4.x applications (as intended).
Because of this, the 15.0.0 will be delisted because of the breaking changes there.
This also introduced a breaking change with MapperConfiguration requiring an ILoggerFactory for logging purposes:
Full Changelog: https://github.com/LuckyPennySoftware/AutoMapper/compare/v14.0.0...v15.0.0
To set your license key:
services.AddAutoMapper(cfg => {
cfg.LicenseKey = "<License key here>";
});
This also introduced a breaking change with MapperConfiguration requiring an ILoggerFactory for logging purposes:
public MapperConfiguration(MapperConfigurationExpression configurationExpression, ILoggerFactory loggerFactory)
Registering AutoMapper with services.AddAutoMapper will automatically supply this parameter. Otherwise you'll need to supply the logger factory.
You can obtain your license key at AutoMapper.io
Reverted the nullable annotations by @lbargaoanu in https://github.com/AutoMapper/AutoMapper/pull/4390
Full Changelog: https://github.com/AutoMapper/AutoMapper/compare/v13.0.1...v14.0.0
Updating to latest template from readthedocs.io by @jbogard in https://github.com/AutoMapper/AutoMapper/pull/4380
Full Changelog: https://github.com/AutoMapper/AutoMapper/compare/v13.0.0...v13.0.1
Emphasized the ProjectTo method call location by @jbogard in https://github.com/AutoMapper/AutoMapper/pull/4105
Full Changelog: https://github.com/AutoMapper/AutoMapper/compare/v12.0.1...v13.0.0
Don't mention a specific upgrade guide anymore by @lbargaoanu in https://github.com/AutoMapper/AutoMapper/pull/4078
Full Changelog: https://github.com/AutoMapper/AutoMapper/compare/v12.0.0...v12.0.1
Prefer derived interfaces by @lbargaoanu in https://github.com/AutoMapper/AutoMapper/pull/3887
Full Changelog: https://github.com/AutoMapper/AutoMapper/compare/v11.0.1...v12.0.0 Upgrade Guide: https://docs.automapper.org/en/latest/12.0-Upgrade-Guide.html
As part of this release we had 10 issues closed.
As part of this release we had 10 issues closed.
Bugs
Improvements/Features
You can download this release from nuget
As part of this release we had 17 issues closed.
As part of this release we had 17 issues closed.
Bugs
Improvements/Features
You can download this release from nuget
As part of this release we had 3 issues closed.
As part of this release we had 6 issues closed.
As part of this release we had 6 issues closed.
Bugs
Improvements/Features
You can download this release from nuget
https://docs.automapper.org/en/latest/10.0-Upgrade-Guide.html
https://docs.automapper.org/en/latest/10.0-Upgrade-Guide.html
As part of this release we had 30 issues closed.
Bugs
Improvements/Features
You can download this release from nuget
As part of this release we had 21 issues closed.
As part of this release we had 21 issues closed.
This release completely removes the static mapper (Mapper.Map) and dynamic mapping. See the 9.0 upgrade guide for details on how to migrate.
Improvements/Features
Bugs
You can download this release from nuget
__#3102__ Deprecate CreateMissingTypeMaps and change the default to false
As part of this release we had 10 issues closed.
Improvements
Bugs
You can download this release from nuget
As part of this release we had 31 issues closed.
As part of this release we had 31 issues closed.
New feature: attribute-based maps
Bugs
Improvements/Features
You can download this release from nuget
As part of this release we had 45 issues closed.
As part of this release we had 45 issues closed.
Bugs
Improvements/Features
You can download this release from nuget
This is a bugfix release to remove the dependency on the deprecated System.Reflection.Emit package from Microsoft.
As part of this release we had 11 issues closed.
This is a bugfix release to remove the dependency on the deprecated System.Reflection.Emit package from Microsoft.
Bugs
Improvements/Features
You can download this release from nuget
As part of this release we had 48 issues closed.
As part of this release we had 48 issues closed.
This release contains mainly bug fixes and a few breaking API changes, as well as an explicit netstandard2.0 target.
Bugs
Improvements/Features
You can download this release from nuget
Nothing published for this version
As part of this release we had 7 issues closed.
As part of this release we had 7 issues closed.
Improvement
Bugs
You can download this release from nuget
As part of this release we had 7 issues closed.
As part of this release we had 7 issues closed.
Improvements
Bugs
You can download this release from nuget
As part of this release we had 70 issues closed.
As part of this release we had 70 issues closed.
Features
Improvements
Bugs
You can download this release from nuget
As part of this release we had 12 issues closed.
As part of this release we had 12 issues closed.
This release includes the ability to turn off the un-flattening behavior added in 6.1.0 using ForPath.Ignore
Bugs
Improvements/Features
You can download this release from nuget
As part of this release we had 28 issues closed.
As part of this release we had 28 issues closed.
Bugs
Improvements/Features
You can download this release from nuget
Removed the unused ValueTuple dependency
Removed the unused ValueTuple dependency
Stupid assembly version was missing.
Stupid assembly version was missing.
As part of this release we had 62 issues closed.
As part of this release we had 62 issues closed.
List of breaking changes:
Features
Improvements
Bugs
You can download this release from nuget
As part of this release we had 74 issues closed.
As part of this release we had 74 issues closed.
Features
Improvements
Bugs
You can download this release from nuget
Nothing published for this version
As part of this release we had 57 issues closed.
As part of this release we had 57 issues closed.
Features
Improvements
Bugs
You can download this release from nuget
Fixed NuGet problem for UWP apps
Fixed NuGet problem for UWP apps
As part of this release we had 60 issues closed.
As part of this release we had 60 issues closed.
Features
Improvements
Bugs
ITypeConverter from int/int? to bool throws exception in 5.0 but works in 4.2.1You can download this release from nuget
As part of this release we had 58 issues closed.
As part of this release we had 58 issues closed.
Features
Improvements
Bugs
You can download this release from nuget
Nothing published for this version
As part of this release we had 2 issues closed.
As part of this release we had 2 issues closed.
As part of this release Mapper.Map and Mapper.Initialize are no longer obsolete. These will be supported going forward.
Mapper.CreateMap is still obsolete and I will kill it with fire.
Improvements
You can download this release from nuget
As part of this release we had 42 issues closed.
As part of this release we had 42 issues closed.
The major change with 4.2 is the static API is marked as obsolete in favor of a new instance-based API. The static API will be removed with 5.0.
Features
Improvements
Bugs
You can download this release from nuget
This is a maintenance release to fix some regressions introduced in the 4.1.0 release and some issues in the NuGet package metadata.
This is a maintenance release to fix some regressions introduced in the 4.1.0 release and some issues in the NuGet package metadata.
As part of this release we had 8 issues closed.
Bugs
You can download this release from nuget
As part of this release we had 49 issues closed.
As part of this release we had 49 issues closed.
Features
Improvements
Bugs
You can download this release from nuget
Nothing published for this version
Nothing published for this version
Nothing published for this version
As part of this release we had 1 issue closed.
As part of this release we had 198 commits which resulted in 77 issues being closed.
As part of this release we had 198 commits which resulted in 77 issues being closed.
This release supports a wide variety of platforms, and consolidates the assemblies so that each platform only references one assembly. It supports:
Features
Improvements
Bugs
You can download this release from nuget
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
One column per quarter.