--- search: boost: 3 hide: - tags tags: - addon_offset - item_label - item_label.remove - item_label.sync - item_genre - item_genre.remove - item_genre.sync - item_edition - non_item_remove_label - item_lock_poster - item_lock_background - item_lock_title - item_assets - item_refresh - item_refresh_delay - item_tmdb_season_titles - item_episode_sorting - item_keep_episodes - item_delete_episodes - item_season_display - item_episode_ordering - item_metadata_language - item_use_original_title - item_credits_detection - item_audio_language - item_subtitle_language - item_subtitle_mode - item_analyze --- # Item Metadata Updates All the following attributes update various details of the metadata for every item in the collection. **None of these updates work with Playlists or Overlays.** | Attribute | Description & Values | |:--------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `item_label` | **Description:** Appends new labels to every movie/show in the collection
**Values:** Comma-separated string of labels to append | | `item_label.remove` | **Description:** Removes existing labels from every movie/show in the collection
**Values:** Comma-separated string of labels to remove | | `item_label.sync` | **Description:** Matches the labels of every movie/show in the collection to the labels provided (Leave blank to remove all labels)
**Values:** Comma-separated string of labels to sync | | `item_genre` | **Description:** Appends new genres to every movie/show in the collection
**Values:** Comma-separated string of genres to append | | `item_genre.remove` | **Description:** Removes existing genres from every movie/show in the collection
**Values:** Comma-separated string of genres to remove | | `item_genre.sync` | **Description:** Matches the genres of every movie/show in the collection to the genres provided (Leave blank to remove all genres)
**Values:** Comma-separated string of genres to sync | | `item_edition` | **Description:** Replaced the edition of every movie in the collection
**Values:** Edition Name | | `non_item_remove_label` | **Description:** Matches every movie/show that has the given label and is not in the collection and removes the label
**Values:** Comma-separated string of labels to remove | | `item_lock_poster` | **Description:** Locks/Unlocks the poster of every movie/show in the collection
**Default:** `None`
**Values:**
`true`Lock
`false`Unlock
| | `item_lock_background` | **Description:** Locks/Unlocks the background of every movie/show in the collection
**Default:** `None`
**Values:**
`true`Lock
`false`Unlock
| | `item_lock_title` | **Description:** Locks/Unlocks the title of every movie/show in the collection
**Default:** `None`
**Values:**
`true`Lock
`false`Unlock
| | `item_assets` | **Description:** Checks your assets folders for assets of every movie/show in the collection
**Default:** `false`
**Values:** `true` or `false` | | `item_refresh` | **Description:** Refreshes the metadata of every movie/show in the collection
**Default:** `false`
**Values:** `true` or `false` | | `item_refresh_delay` | **Description:** Amount of time to wait between each `item_refresh` of every movie/show in the collection
**Default:** `0`
**Values:** Number greater than `0` | | `item_analyze` | **Description:** Runs Plex's Analyze Operation on every movie/show in the collection
**Default:** `false`
**Values:** `true` or `false` | | `item_tmdb_season_titles` | **Description:** Changes the season titles of every show in the collection to match TMDb
**Default:** `false`
**Values:** `true` or `false` | | `item_episode_sorting`1 | **Description:** Changes the episode sorting of every show in the collection
**Values:**
`default`Library default
`oldest`Oldest first
`newest`Newest first
| | `item_keep_episodes`1 | **Description:** Changes the keep episodes of every show in the collection
**Values:**
`all`All episodes
`5_latest`5 latest episodes
`3_latest`3 latest episodes
`latest`Latest episodes
`past_3`Episodes added in the past 3 days
`past_7`Episodes added in the past 7 days
`past_30`Episodes added in the past 30 days
| | `item_delete_episodes`1 | **Description:** Changes the delete episodes of every show in the collection
**Values:**
`never`Never
`day`After a day
`week`After a week
`month`After a month
`refresh`On next refresh
| | `item_season_display`1 | **Description:** Changes the season display of every show in the collection
**Values:**
`default`Library default
`show`Show
`hide`Hide
| | `item_episode_ordering`1 | **Description:** Changes the episode ordering of every show in the collection
**Values:**
`default`Library default
`tmdb_aired`The Movie Database (Aired)
`tvdb_aired`TheTVDb (Aired)
`tvdb_dvd`TheTVDb (DVD)
`tvdb_absolute`TheTVDb (Absolute)
| | `item_metadata_language`2 | **Description:** Changes the metadata language of every movie/show in the collection
**Values:** `default`, `ar-SA`, `ca-ES`, `cs-CZ`, `da-DK`, `de-DE`, `el-GR`, `en-AU`, `en-CA`, `en-GB`, `en-US`, `es-ES`, `es-MX`, `et-EE`, `fa-IR`, `fi-FI`, `fr-CA`, `fr-FR`, `he-IL`, `hi-IN`, `hu-HU`, `id-ID`, `it-IT`, `ja-JP`, `ko-KR`, `lt-LT`, `lv-LV`, `nb-NO`, `nl-NL`, `pl-PL`, `pt-BR`, `pt-PT`, `ro-RO`, `ru-RU`, `sk-SK`, `sv-SE`, `th-TH`, `tr-TR`, `uk-UA`, `vi-VN`, `zh-CN`, `zh-HK`, `zh-TW` | | `item_use_original_title`2 | **Description:** Changes the use original title of every movie/show in the collection
**Values:**
`default`Library default
`no`No
`yes`Yes
| | `item_credits_detection`2 | **Description:** Changes the enable credits detection of every movie/show in the collection
**Values:**
`default`Library default
`disabled`Disabled
| | `item_audio_language`2 | **Description:** Changes the preferred audio language of every movie/show in the collection
**Values:** `default`, `en`, `ar-SA`, `ca-ES`, `cs-CZ`, `da-DK`, `de-DE`, `el-GR`, `en-AU`, `en-CA`, `en-GB`, `en-US`, `es-ES`, `es-MX`, `et-EE`, `fa-IR`, `fi-FI`, `fr-CA`, `fr-FR`, `he-IL`, `hi-IN`, `hu-HU`, `id-ID`, `it-IT`, `ja-JP`, `ko-KR`, `lt-LT`, `lv-LV`, `nb-NO`, `nl-NL`, `pl-PL`, `pt-BR`, `pt-PT`, `ro-RO`, `ru-RU`, `sk-SK`, `sv-SE`, `th-TH`, `tr-TR`, `uk-UA`, `vi-VN`, `zh-CN`, `zh-HK`, `zh-TW` | | `item_subtitle_language`2 | **Description:** Changes the preferred subtitle language of every movie/show in the collection
**Values:** `default`, `en`, `ar-SA`, `ca-ES`, `cs-CZ`, `da-DK`, `de-DE`, `el-GR`, `en-AU`, `en-CA`, `en-GB`, `en-US`, `es-ES`, `es-MX`, `et-EE`, `fa-IR`, `fi-FI`, `fr-CA`, `fr-FR`, `he-IL`, `hi-IN`, `hu-HU`, `id-ID`, `it-IT`, `ja-JP`, `ko-KR`, `lt-LT`, `lv-LV`, `nb-NO`, `nl-NL`, `pl-PL`, `pt-BR`, `pt-PT`, `ro-RO`, `ru-RU`, `sk-SK`, `sv-SE`, `th-TH`, `tr-TR`, `uk-UA`, `vi-VN`, `zh-CN`, `zh-HK`, `zh-TW` | | `item_subtitle_mode`2 | **Description:** Changes the auto-select subtitle mode of every movie/show in the collection
**Values:**
`default`Account default
`manual`Manually selected
`foreign`Shown with foreign audio
`always`Always enabled
| 1 Only works with TV Show Libraries 2 Must be using the **New Plex Movie Agent** or the **New Plex TV Agent**