AutoMapper 14.0.0

AutoMapper

CI NuGet MyGet (dev) 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>();
});
// only during development, validate your mappings; remove it before release
#if DEBUG
configuration.AssertConfigurationIsValid();
#endif
// use DI (http://docs.automapper.org/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 or in our Gitter.

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?

First check if it's already fixed by trying the MyGet build.

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

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

License, etc.

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. For more information see the .NET Foundation Code of Conduct.

AutoMapper is Copyright © 2009 Jimmy Bogard and other contributors under the MIT license.

.NET Foundation

This project is supported by the .NET Foundation.

Showing the top 20 packages that depend on AutoMapper.

Packages Downloads
IdentityServer3.EntityFramework
Entity Framework-based persistence layer for IdentityServer3
106
AutoMapper.EF6
Extensions to make AutoMapper easier to work with Entity Framework. Project to collections and items, decompiling calculated properties along the way
82
Nuke.Common
Cross-platform build automation system
67
Nuke.Common
Cross-platform build automation system
63
Nuke.Common
Cross-platform build automation system
60
Nuke.Common
Cross-platform build automation system
54
Nuke.Common
Cross-platform build automation system
53
Nuke.Common
Cross-platform build automation system
51
IdentityServer4.EntityFramework.Storage
EntityFramework persistence layer for IdentityServer4
50
Nuke.Common
Cross-platform build automation system
50
Nuke.Common
Cross-platform build automation system
47
Nuke.Common
Cross-platform build automation system
46
Nuke.Common
Cross-platform build automation system
45
Nuke.Common
Cross-platform build automation system
43
Nuke.Common
Cross-platform build automation system
42
Nuke.Common
Cross-platform build automation system
41
Nuke.Common
Cross-platform build automation system
40

.NET 8.0

Version Downloads Last updated
14.0.0 11 02/17/2025
13.0.1 23 02/19/2024
12.0.1 33 04/19/2023
12.0.0 15 03/02/2023
11.0.1 24 05/19/2022
11.0.0 13 08/29/2023
10.1.1 82 01/17/2021
10.0.0 12 08/27/2023
9.0.0 52 06/18/2020
8.1.1 18 06/11/2023
8.1.0 14 02/19/2024
8.0.0 16 06/14/2023
7.0.1 525 11/14/2019
7.0.0-alpha-0001 25 08/31/2023
6.2.2 16 06/13/2023
6.2.1 19 06/13/2023
6.2.0 15 06/13/2023
6.1.1 14 06/13/2023
6.1.0 14 06/13/2023
6.0.2 15 06/12/2023
5.2.0 19 06/12/2023
5.1.1 30 11/25/2019
5.0.2 57 11/13/2019
5.0.0-beta-1 20 02/19/2024
4.2.1 17 06/12/2023
4.2.0 13 06/13/2023
4.1.1 15 06/12/2023
4.0.4 15 06/13/2023
4.0.0-alpha1 19 08/30/2023
3.3.1 18 06/12/2023
3.3.0 14 06/13/2023
3.2.1 17 12/07/2023
3.1.1 14 06/12/2023
3.1.0 15 06/12/2023
3.0.0 11 06/12/2023
2.2.1 16 06/12/2023
2.2.0 17 06/13/2023
2.1.267 18 08/28/2023
2.1.266 19 08/26/2023
2.1.265 19 08/25/2023
2.1.262 15 08/30/2023
2.1.1 13 06/13/2023
2.0.0 12 06/12/2023
1.1.2 14 06/12/2023
1.1.0.118 18 02/19/2024