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
 270
AutoMapper.Extensions.Microsoft.DependencyInjection
AutoMapper extensions for ASP.NET Core
 429
AutoMapper.Extensions.Microsoft.DependencyInjection
AutoMapper extensions for ASP.NET Core
 574
Finsa.Caravan.Common.Runtime
A long description of the package. This shows up in the right pane of the Add Package Dialog as well as in the Package Manager Console when listing packages using the Get-Package command. THIS PACKAGE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE PACKAGE OR THE USE OR OTHER DEALINGS IN THE PACKAGE.
 156
Finsa.Caravan.Common.Runtime
A long description of the package. This shows up in the right pane of the Add Package Dialog as well as in the Package Manager Console when listing packages using the Get-Package command. THIS PACKAGE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE PACKAGE OR THE USE OR OTHER DEALINGS IN THE PACKAGE.
 203
Finsa.CaravanCore
Package Description
 107
Finsa.CaravanCore
Package Description
 110
Finsa.CaravanCore
Package Description
 114
Finsa.CaravanCore
Package Description
 116
Finsa.CaravanCore
Package Description
 162
Finsa.CaravanCore
Package Description
 187
Finsa.CaravanCore
Package Description
 215
Finsa.CaravanCore
Package Description
 299
Finsa.CaravanCore
Package Description
 393
Finsa.CaravanCore
Package Description
 443
Finsa.CaravanCore
Package Description
 482
Finsa.CaravanCore
Package Description
 582
Finsa.CaravanCore
Package Description
 1,269
Finsa.CaravanCore
Package Description
 2,173
IdentityServer4.EntityFramework.Storage
EntityFramework persistence layer for IdentityServer4
 119

.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 4 12/06/2025
16.0.0-beta-1 0 11/20/2025
15.1.0 4 10/26/2025
15.0.1 16 07/18/2025
15.0.0 7 08/19/2025
14.0.0 24 02/20/2025
13.0.1 34 02/08/2024
12.0.1 31 12/29/2023
12.0.0 35 10/18/2022
11.0.1 180 02/18/2022
11.0.0 37 02/08/2024
10.1.1 1,050 10/21/2020
10.1.0 38 11/03/2020
10.0.0 132 08/24/2020
9.0.0 98 02/10/2020
8.1.1 50 02/05/2024
8.1.0 34 02/08/2024
8.0.0 34 02/08/2024
7.0.1 26 02/10/2020
7.0.0-alpha-0001 29 02/08/2024
6.2.2 41 07/04/2020
6.2.1 36 02/08/2024
6.2.0 29 02/10/2020
6.1.1 31 02/10/2020
6.1.0 26 02/08/2024
6.0.2 29 02/10/2020
5.2.0 180 02/10/2020
5.1.1 51 02/10/2020
5.0.2 27 02/10/2020
5.0.0-beta-1 32 02/08/2024
4.2.1 28 02/10/2020
4.2.0 25 02/10/2020
4.1.1 26 02/10/2020
4.1.0 26 02/10/2020
4.0.4 35 02/10/2020
4.0.0-alpha1 31 02/08/2024
3.3.1 28 02/10/2020
3.3.0 30 02/08/2024
3.2.1 26 07/05/2021
3.1.1 33 02/08/2024
3.1.0 40 02/08/2024
3.0.0 33 02/08/2024
2.2.1 28 01/11/2024
2.2.0 28 02/08/2024
2.1.267 39 02/08/2024
2.1.266 31 02/08/2024
2.1.265 32 02/08/2024
2.1.262 30 02/08/2024
2.1.1 31 02/08/2024
2.0.0 33 02/08/2024
1.1.2 32 01/13/2024
1.1.0.118 31 02/08/2024