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_sorting¹

Description: Changes the episode sorting of every show in the collection
Values:

`default`	Library default
`oldest`	Oldest first
`newest`	Newest first

item_keep_episodes¹

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¹

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¹

Description: Changes the season display of every show in the collection
Values:

`default`	Library default
`show`	Show
`hide`	Hide

item_episode_ordering¹

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² 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²

Description: Changes the use original title of every movie/show in the collection
Values:

`default`	Library default
`no`	No
`yes`	Yes

item_credits_detection²

Description: Changes the enable credits detection of every movie/show in the collection
Values:

`default`	Library default
`disabled`	Disabled

item_audio_language² 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² 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²

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