---
title: "Import field mappings"
method: POST
path: "/api/Settings/import-field-mappings"
tags: ["Settings"]
---

# Import field mappings

`POST /api/Settings/import-field-mappings`

## Request

- Base URL: `http://localhost:5000`
- URL: `http://localhost:5000/api/Settings/import-field-mappings`
- Auth: API key in header `x-api-key`

## Request body

- ImportFieldMappingsDto
  - `settings` ImportSettingsDto
    - `importMode` 0 | 1: Members: - `0` — Replace - `1` — Merge
    - `resolution` 0 | 1 | 2: Members: - `0` — Manual - `1` — Keep - `2` — Replace
    - `whitelist` boolean
    - `blacklist` boolean
    - `ageRatings` boolean
    - `fieldMappings` boolean
    - `ageRatingConflictResolutions` object, nullable
  - `data` FieldMappingsDto
    - `blacklist` string[], nullable
    - `whitelist` string[], nullable
    - `ageRatingMappings` object, nullable
    - `fieldMappings` MetadataFieldMappingDto[], nullable
      - `id` integer
      - `sourceType` 0 | 1: Members: - `0` — Genre - `1` — Tag
      - `destinationType` 0 | 1: Members: - `0` — Genre - `1` — Tag
      - `sourceValue` string, nullable
      - `destinationValue` string, nullable
      - `excludeFromSource` boolean

## Response `200`

OK

- FieldMappingsImportResultDto
  - `success` boolean
  - `resultingMetadataSettings` MetadataSettingsDto
    - `blacklist` string[], nullable
    - `whitelist` string[], nullable
    - `ageRatingMappings` object, nullable
    - `fieldMappings` MetadataFieldMappingDto[], nullable
      - `id` integer
      - `sourceType` 0 | 1: Members: - `0` — Genre - `1` — Tag
      - `destinationType` 0 | 1: Members: - `0` — Genre - `1` — Tag
      - `sourceValue` string, nullable
      - `destinationValue` string, nullable
      - `excludeFromSource` boolean
    - `enabled` boolean
    - `enableExtendedMetadataProcessing` boolean
    - `enableSummary` boolean
    - `enablePublicationStatus` boolean
    - `enableAgeRating` boolean
    - `enableRelationships` boolean
    - `enablePeople` boolean
    - `enableStartDate` boolean
    - `enableLocalizedName` boolean
    - `enableName` boolean
    - `enableCoverImage` boolean
    - `enableChapterSummary` boolean
    - `enableChapterReleaseDate` boolean
    - `enableChapterTitle` boolean
    - `enableChapterPublisher` boolean
    - `enableChapterCoverImage` boolean
    - `enableVolumeCoverImage` boolean
    - `enableGenres` boolean
    - `enableTags` boolean
    - `firstLastPeopleNaming` boolean
    - `externalAgeRatingMappings` object, nullable
    - `globalLanguageTitleSettings` SeriesNameLanguageDto
      - `name` string, nullable
      - `localizedName` string, nullable
    - `libraryLanguageTitleOverrides` object, nullable
    - `overrides` MetadataSettingField[], nullable
    - `personRoles` PersonRole[], nullable
    - `filterAboveWeight` 1 | 2 | 3 | 4 | 5: Members: - `1` — Core - `2` — Defining - `3` — Recurrent - `4` — Incidental - `5` — Unweighted
  - `ageRatingConflicts` string[], nullable

## Changes

- **2026-08-27** `61318f996251`: 3 warning
  - added the new `11.00` enum value to the `resultingMetadataSettings/overrides/items/` response property for the response status `200` (media type: text/plain)
  - added the new `11.00` enum value to the `resultingMetadataSettings/overrides/items/` response property for the response status `200` (media type: application/json)
  - added the new `11.00` enum value to the `resultingMetadataSettings/overrides/items/` response property for the response status `200` (media type: text/json)
- **2026-08-13** `3bd8363f0a4e`: 9 info
  - added the optional property `resultingMetadataSettings/enableAgeRating` to the response with the `200` status (media type: text/plain)
  - added the optional property `resultingMetadataSettings/enableAgeRating` to the response with the `200` status (media type: application/json)
  - added the optional property `resultingMetadataSettings/enableAgeRating` to the response with the `200` status (media type: text/json)
  - added the optional property `resultingMetadataSettings/externalAgeRatingMappings` to the response with the `200` status (media type: text/plain)
  - …5 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/kareadita/apis/kavita/changes/api/Settings/import-field-mappings/post.md)

---

[API](https://skmtc.dev/kareadita/apis/kavita.md) - [All operations](https://skmtc.dev/kareadita/apis/kavita/llms.txt) - [OpenAPI document](https://skmtc.dev/kareadita/apis/kavita/revisions/d266465eeb67?raw)