Skip to content

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:
trueLock
falseUnlock
item_lock_background Description: Locks/Unlocks the background of every movie/show in the collection
Default: None
Values:
trueLock
falseUnlock
item_lock_title Description: Locks/Unlocks the title of every movie/show in the collection
Default: None
Values:
trueLock
falseUnlock
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:
defaultLibrary default
oldestOldest first
newestNewest first
item_keep_episodes1 Description: Changes the keep episodes of every show in the collection
Values:
allAll episodes
5_latest5 latest episodes
3_latest3 latest episodes
latestLatest episodes
past_3Episodes added in the past 3 days
past_7Episodes added in the past 7 days
past_30Episodes added in the past 30 days
item_delete_episodes1 Description: Changes the delete episodes of every show in the collection
Values:
neverNever
dayAfter a day
weekAfter a week
refreshOn next refresh
item_season_display1 Description: Changes the season display of every show in the collection
Values:
defaultLibrary default
showShow
hideHide
item_episode_ordering1 Description: Changes the episode ordering of every show in the collection
Values:
defaultLibrary default
tmdb_airedThe Movie Database (Aired)
tvdb_airedTheTVDb (Aired)
tvdb_dvdTheTVDb (DVD)
tvdb_absoluteTheTVDb (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:
defaultLibrary default
noNo
yesYes

1 Only works with TV Show Libraries

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