AutoMapper 16.0.0

AutoMapper

CI NuGet Documentation Status

What is AutoMapper?

AutoMapper is a simple little library built to solve a deceptively complex problem - getting rid of code that mapped one object to another. This type of code is rather dreary and boring to write, so why not invent a tool to do it for us?

This is the main repository for AutoMapper, but there's more:

How do I get started?

First, configure AutoMapper to know what types you want to map, in the startup of your application:

var configuration = new MapperConfiguration(cfg => 
{
    cfg.CreateMap<Foo, FooDto>();
    cfg.CreateMap<Bar, BarDto>();
}, loggerFactory);

// or more typically, using IServiceCollection
services.AddAutoMapper(cfg => 
{
    cfg.CreateMap<Foo, FooDto>();
    cfg.CreateMap<Bar, BarDto>();
});

// only during development, validate your mappings; remove it before release
#if DEBUG
configuration.AssertConfigurationIsValid();
#endif
// use DI (http://docs.automapper.io/en/latest/Dependency-injection.html) or create the mapper yourself
var mapper = configuration.CreateMapper();

Then in your application code, execute the mappings:

var fooDto = mapper.Map<FooDto>(foo);
var barDto = mapper.Map<BarDto>(bar);

Check out the getting started guide. When you're done there, the wiki goes in to the nitty-gritty details. If you have questions, you can post them to Stack Overflow.

Where can I get it?

First, install NuGet. Then, install AutoMapper from the package manager console:

PM> Install-Package AutoMapper

Or from the .NET CLI as:

dotnet add package AutoMapper

Do you have an issue?

You might want to know exactly what your mapping does at runtime.

If you're still running into problems, file an issue above.

If you are a paying customer, you can contact support via your account.

How do I set the license key?

You can set the license key when registering AutoMapper:

services.AddAutoMapper(cfg => 
{
    cfg.LicenseKey = "<license key here>";
})

You can register for your license key at AutoMapper.io

Showing the top 20 packages that depend on AutoMapper.

Packages Downloads
AutoMapper.Extensions.Microsoft.DependencyInjection
AutoMapper extensions for ASP.NET Core
 108
AutoMapper.Extensions.Microsoft.DependencyInjection
AutoMapper extensions for ASP.NET Core
 110
AutoMapper.Extensions.Microsoft.DependencyInjection
AutoMapper extensions for ASP.NET Core
 113
AutoMapper.Extensions.Microsoft.DependencyInjection
AutoMapper extensions for ASP.NET Core
 125
AutoMapper.Extensions.Microsoft.DependencyInjection
AutoMapper extensions for ASP.NET Core
 139
AutoMapper.Extensions.Microsoft.DependencyInjection
AutoMapper extensions for ASP.NET Core
 756
DHP.Core
Package Description
 116
DHP.Core
Package Description
 118
DHP.Core
Package Description
 208
Duende.IdentityServer.EntityFramework.Storage
EntityFramework persistence layer for Duende IdentityServer
 108
Duende.IdentityServer.EntityFramework.Storage
EntityFramework persistence layer for Duende IdentityServer
 109
Duende.IdentityServer.EntityFramework.Storage
EntityFramework persistence layer for Duende IdentityServer
 111
Duende.IdentityServer.EntityFramework.Storage
EntityFramework persistence layer for Duende IdentityServer
 112
Duende.IdentityServer.EntityFramework.Storage
EntityFramework persistence layer for Duende IdentityServer
 113
Duende.IdentityServer.EntityFramework.Storage
EntityFramework persistence layer for Duende IdentityServer
 114
Duende.IdentityServer.EntityFramework.Storage
EntityFramework persistence layer for Duende IdentityServer
 117
Nuke.Common
Cross-platform build automation system
 110
Nuke.Common
Cross-platform build automation system
 112

.NET Framework 4.7.1

.NET Standard 2.0

.NET 10.0

.NET 9.0

.NET 8.0

Version Downloads Last updated
16.0.0 11 12/04/2025
16.0.0-beta-1 20 11/21/2025
15.1.0 40 10/24/2025
15.0.1 76 07/11/2025
15.0.0 58 07/03/2025
14.0.0 387 02/16/2025
13.0.1 506 02/13/2024
12.0.1 410 02/04/2024
12.0.0 127 02/04/2024
11.0.1 98 07/22/2024
11.0.0 139 02/04/2024
10.1.1 129 02/09/2024
10.0.0 93 07/13/2024
9.0.0 99 07/22/2024
8.1.1 90 07/22/2024
8.1.0 100 07/22/2024
8.0.0 89 07/22/2024
7.0.1 108 07/22/2024
7.0.0-alpha-0001 98 07/22/2024
6.2.2 109 07/22/2024
6.2.1 93 07/22/2024
6.2.0 104 07/22/2024
6.1.1 103 07/22/2024
6.1.0 101 07/22/2024
6.0.2 88 07/18/2024
5.2.0 115 07/22/2024
5.1.1 95 07/18/2024
5.0.2 106 07/22/2024
5.0.0-beta-1 111 07/22/2024
4.2.1 99 07/22/2024
4.2.0 106 07/22/2024
4.1.1 102 07/22/2024
4.0.4 100 07/22/2024
4.0.0-alpha1 98 07/22/2024
3.3.1 101 07/22/2024
3.3.0 93 07/22/2024
3.2.1 101 07/22/2024
3.1.1 100 07/22/2024
3.1.0 117 07/22/2024
3.0.0 100 07/22/2024
2.2.1 105 07/22/2024
2.2.0 95 07/22/2024
2.1.267 93 07/22/2024
2.1.266 96 07/22/2024
2.1.265 102 07/22/2024
2.1.262 99 07/22/2024
2.1.1 99 07/22/2024
2.0.0 96 07/22/2024
1.1.2 96 07/22/2024
1.1.0.118 96 07/22/2024