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

# Import field mappings

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

## 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
    - `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
    - `globalLanguageTitleSettings` SeriesNameLanguageDto
      - `name` string, nullable
      - `localizedName` string, nullable
    - `libraryLanguageTitleOverrides` object, nullable
    - `overrides` MetadataSettingField[], nullable
    - `personRoles` PersonRole[], nullable
  - `ageRatingConflicts` string[], nullable

---

[API](https://skmtc.net/kareadita/apis/kavita.md) · [All operations](https://skmtc.net/kareadita/apis/kavita/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kareadita/kavita/revisions/a092f0284f3e/schema)