# Movie Library Metadata
You can have the script edit the metadata of Movies by adding them to the `metadata` mapping of a Metadata File.
An example of multiple metadata edits in a movie library is below:
```yaml
metadata:
Godzilla (1954):
title: Godzilla
year: 1954
content_rating: R
Godzilla (1998):
title: Godzilla
year: 1998
sort_title: Godzilla 03
content_rating: PG-13
Shin Godzilla:
sort_title: Godzilla 06
content_rating: R
Godzilla 1985:
content_rating: PG
"Godzilla 2000: Millennium":
originally_available: 1999-08-18
Godzilla Against MechaGodzilla:
originally_available: 2002-03-23
Godzilla Raids Again:
content_rating: G
originally_available: 1955-05-21
Godzilla vs. Biollante:
content_rating: PG
Godzilla vs. Destoroyah:
content_rating: PG
originally_available: 1995-01-19
Godzilla vs. Gigan:
content_rating: G
originally_available: 1972-09-14
Godzilla vs. Hedorah:
content_rating: G
originally_available: 1971-04-01
Godzilla vs. King Ghidorah:
content_rating: PG
originally_available: 1991-04-28
Godzilla vs. Mechagodzilla:
content_rating: G
originally_available: 1974-03-24
Godzilla vs. Mechagodzilla II:
content_rating: PG
Godzilla vs. Megaguirus:
content_rating: PG
originally_available: 2000-08-31
Godzilla vs. Megalon:
content_rating: G
originally_available: 1973-03-17
Godzilla vs. Mothra:
content_rating: PG
originally_available: 1992-04-28
Godzilla vs. SpaceGodzilla:
content_rating: PG
originally_available: 1994-01-19
Godzilla, King of the Monsters!:
content_rating: G
"Godzilla, Mothra and King Ghidorah: Giant Monsters All-Out Attack":
content_rating: PG
originally_available: 2001-08-31
"Godzilla: Final Wars":
content_rating: PG
originally_available: 2004-12-13
"Godzilla: Tokyo S.O.S.":
originally_available: 2003-12-14
Halloween (Rob Zombie):
alt_title: Halloween
year: 2007
"Halo 4: Forward Unto Dawn":
alt_title: Halo 4 Forward Unto Dawn
tmdb_show: 56295
content_rating: R
```
## Movies
Each movie is defined by the mapping name which must be the same as the movie name in the library unless an `alt_title` is specified.
## Metadata Edits
The available attributes for editing movies are as follows
### Special Attributes
| Attribute | Allowed Values |
|:-------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `title` | Title if different from the mapping value useful when you have multiple movies with the same name. See the [Metadata Page ](../metadata.md#metadata-attributes ) for how searching for files works. |
| `alt_title` | Alternative title to look for and then change to the mapping name. See the [Metadata Page ](../metadata.md#metadata-attributes ) for how searching for files works. |
| `year` | Year of movie for better identification. See the [Metadata Page ](../metadata.md#metadata-attributes ) for how searching for files works. |
| `tmdb_show` | TMDb Show ID to use for metadata useful for miniseries that have been compiled into a movie. **This is not used to say this show is the given ID.** |
| `tmdb_movie` | TMDb Movie ID to use for metadata useful for movies that have been split into segments **This is not used to say this show is the given ID.** |
### General Attributes
| Attribute | Allowed Values |
|:-----------------------|:--------------------------------------------------------------|
| `sort_title` | Text to change Sort Title |
| `original_title` | Text to change Original Title |
| `originally_available` | Date to change Originally Available< br > **Format:** YYYY-MM-DD |
| `content_rating` | Text to change Content Rating |
| `user_rating` | Number to change User Rating |
| `audience_rating` | Number to change Audience Rating |
| `critic_rating` | Number to change Critic Rating |
| `studio` | Text to change Studio |
| `tagline` | Text to change Tagline |
| `summary` | Text to change Summary |
### Tag Attributes
You can add `.remove` to any tag attribute to only remove those tags i.e. `genre.remove` .
You can add `.sync` to any tag attribute to sync all tags vs just appending the new ones i.e. `genre.sync` .
| Attribute | Allowed Values |
|:-------------|:----------------------------------------------------|
| `director` | List or comma-separated text of each Director Tag |
| `country` | List or comma-separated text of each Country Tag |
| `genre` | List or comma-separated text of each Genre Tag |
| `writer` | List or comma-separated text of each Writer Tag |
| `producer` | List or comma-separated text of each Producer Tag |
| `collection` | List or comma-separated text of each Collection Tag |
| `label` | List or comma-separated text of each Label Tag |
### Advanced Attributes
| Attribute | Allowed Values |
|:---------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `metadata_language` | `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` |
| `use_original_title` | `default` : Library default< br > `no`: No< br > `yes`: Yes |
\* Must be using the **New Plex Movie Agent*
### Image Attributes
| Attribute | Description | Allowed Values |
|:------------------|:----------------------------------------------------------------------|:------------------------------------------------|
| `url_poster` | Used to change the movie's poster to the URL | URL of image publicly available on the internet |
| `file_poster` | Used to change the movie's poster to the image in the file system | Path to image in the file system |
| `url_background` | Use to change the movie's background to the URL | URL of image publicly available on the internet |
| `file_background` | Used to change the movie's background to the image in the file system | Path to image in the file system |