---
title: "Get the metadata settings for Kavita+ users."
method: GET
path: "/api/Settings/metadata-settings"
tags: ["Settings"]
---

# Get the metadata settings for Kavita+ users.

`GET /api/Settings/metadata-settings`

## Request

- Base URL: `http://localhost:5000`
- URL: `http://localhost:5000/api/Settings/metadata-settings`
- Auth: API key in header `x-api-key`

## Response `200`

OK

- 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

## Changes

- **2026-08-27** `61318f996251`: 3 warning
  - added the new `11.00` enum value to the `overrides/items/` response property for the response status `200` (media type: text/plain)
  - added the new `11.00` enum value to the `overrides/items/` response property for the response status `200` (media type: application/json)
  - added the new `11.00` enum value to the `overrides/items/` response property for the response status `200` (media type: text/json)
- **2026-08-13** `3bd8363f0a4e`: 9 info
  - added the optional property `enableAgeRating` to the response with the `200` status (media type: text/plain)
  - added the optional property `enableAgeRating` to the response with the `200` status (media type: application/json)
  - added the optional property `enableAgeRating` to the response with the `200` status (media type: text/json)
  - added the optional property `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/metadata-settings/get.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)