Plex-Meta-Manager/docs/files/item_updates.md

search	hide	tags
boost 3	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 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_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_sorting1	Description: Changes the episode sorting of every show in the collection Values: default Library default oldest Oldest first newest Newest first
item_keep_episodes1	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_episodes1	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_display1	Description: Changes the season display of every show in the collection Values: default Library default show Show hide Hide
item_episode_ordering1	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_language2	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_title2	Description: Changes the use original title of every movie/show in the collection Values: default Library default no No yes Yes
item_credits_detection2	Description: Changes the enable credits detection of every movie/show in the collection Values: default Library default disabled Disabled
item_audio_language2	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_language2	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_mode2	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

¹ Only works with TV Show Libraries

² Must be using the New Plex Movie Agent or the New Plex TV Agent