AutoMapper 15.0.1

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
Nuke.Common
Cross-platform build automation system
 46
AutoMapper.Collection
Collection Add/Remove/Update support for AutoMapper. AutoMapper.Collection adds EqualityComparison Expressions for TypeMaps to determine if Source and Destination type are equivalent to each other when mapping collections.
 44
Nuke.Common
Cross-platform build automation system
 44
Nuke.Common
Cross-platform build automation system
 43
AutoMapper.Collection
Collection Add/Remove/Update support for AutoMapper. AutoMapper.Collection adds EqualityComparison Expressions for TypeMaps to determine if Source and Destination type are equivalent to each other when mapping collections.
 42
KubernetesClient
Client library for the Kubernetes open source container orchestrator.
 42
AutoMapper.Collection
Collection updating support for AutoMapper
 41
Nuke.Common
Cross-platform build automation system
 41
KubernetesClient
Client library for the Kubernetes open source container orchestrator.
 40

.NET 8.0

.NET 9.0

.NET Standard 2.0

Version Downloads Last updated
15.0.1 12 7/12/2025
15.0.0 18 7/3/2025
14.0.0 32 2/20/2025
13.0.1 50 2/12/2024
13.0.0 46 2/6/2024
12.0.1 59 7/2/2023
12.0.0 46 7/2/2023
11.0.1 43 7/2/2023
11.0.0 48 7/2/2023
10.1.1 49 4/12/2022
10.0.0 55 7/2/2023
9.0.0 41 7/2/2023
8.1.1 40 7/2/2023
8.1.0 41 7/2/2023
8.0.0 41 7/2/2023
7.0.1 51 7/2/2023
7.0.0-alpha-0001 38 7/2/2023
6.2.2 60 7/2/2023
6.2.1 45 7/2/2023
6.2.0 39 7/2/2023
6.1.1 41 7/2/2023
6.1.0 60 7/2/2023
6.0.2 39 7/2/2023
5.2.0 46 7/2/2023
5.1.1 43 7/2/2023
5.0.2 36 7/2/2023
5.0.0-beta-1 37 7/2/2023
4.2.1 37 7/2/2023
4.2.0 48 7/2/2023
4.1.1 41 7/2/2023
4.0.4 40 7/2/2023
4.0.0-alpha1 41 7/2/2023
3.3.1 44 7/2/2023
3.3.0 41 7/2/2023
3.2.1 45 7/2/2023
3.1.1 41 7/2/2023
3.1.0 41 7/2/2023
3.0.0 36 7/2/2023
2.2.1 39 7/2/2023
2.2.0 37 7/2/2023
2.1.267 42 7/2/2023
2.1.266 38 7/2/2023
2.1.265 37 7/2/2023
2.1.262 33 7/2/2023
2.1.1 31 7/2/2023
2.0.0 43 7/2/2023
1.1.2 38 7/2/2023
1.1.0.118 38 7/2/2023