
By default, most tags can be updated, regardless of the content review status. When you send a metadata delivery to update those tags, the changes are applied without a review (see the definition of Pass-Through below).
Updates to the following tags will be ignored:
Language (the <language> tag under <package> and <artist>)
Provider
Vendor ID
Keep the following definitions in mind when sending metadata updates:
Pass-Through: When you send a metadata update to make changes to tags that do not require a ticket, those changes are applied without having to be reviewed by Apple; this is referred to as Pass-Through because the changes are applied automatically without a ticket and without review.
Ticket Required: For these fields, an outstanding ticket is required in order to make changes via XML. Changes will be applied to the ticket for review. When the ticket is approved by Apple, the changes will go live. If there is no outstanding ticket on the content when the XML is submitted, changes to these fields are ignored.
Ticket Optional: For these fields, changes will be applied immediately as a Pass-Through unless there is an outstanding ticket. If there is an outstanding ticket, then the changes are appended to the ticket instead of being applied immediately; when Apple approves the ticket, the changes will go live.
Create Ticket: For these fields, Apple will automatically create a ticket when you submit an update. The ticket is subject to review by Apple. When Apple approves the ticket, the change will go live.
The table below lists only the tags that may require a ticket in certain circumstances; it does not list the tags that are always Pass-Through or always ignored. Below each tag, review statuses are listed. Checkmarks appear in a column to indicate if the tag can be updated and under which conditions.
Album and Track Titles |
|---|
Pass-Through | Ticket Optional | Create Ticket | Ticket Required | Cannot Be Updated | |
Not Live / Waiting for Review | √ | ||||
Ready / Reviewed | √ | ||||
Ready / Not Reviewed | √ | ||||
Live / Reviewed | √ | ||||
Live / Not Reviewed | √ |
Album and Track Artists; Artist Apple Identifier |
|---|
Note: Updating artists includes adding or removing the artist, changing the order of the artists, or changing the primary status; you cannot update an artist to correct a typo or misspelling. |
Pass-Through | Ticket Optional | Create Ticket | Ticket Required | Cannot Be Updated | |
Not Live / Waiting for Review | √ | ||||
Ready / Reviewed | √ | ||||
Ready / Not Reviewed | √ | ||||
Live / Reviewed | √ | ||||
Live / Not Reviewed | √ |
Album Genres |
|---|
Pass-Through | Ticket Optional | Create Ticket | Ticket Required | Cannot Be Updated | |
Not Live / Waiting for Review | √ | ||||
Ready / Reviewed | √ | ||||
Ready / Not Reviewed | √ | ||||
Live / Reviewed | √ | ||||
Live / Not Reviewed | √ |
Track Audio Language |
|---|
Pass-Through | Ticket Optional | Create Ticket | Ticket Required | Cannot Be Updated | |
Not Live / Waiting for Review | √ | ||||
Ready / Reviewed | √ | ||||
Ready / Not Reviewed | √ | ||||
Live / Reviewed | √ | ||||
Live / Not Reviewed | √ |
Original Release Date |
|---|
Pass-Through | Ticket Optional | Create Ticket | Ticket Required | Cannot Be Updated | |
Not Live / Waiting for Review | √ | ||||
Ready / Reviewed | √ | ||||
Ready / Not Reviewed | √ | ||||
Live / Reviewed | √ | ||||
Live / Not Reviewed | √ |
Album Cover Art |
|---|
Note: This change is applied only if the checksum of the new cover differs from the checksum of the cover currently in the iTunes database. |
Pass-Through | Ticket Optional | Create Ticket | Ticket Required | Cannot Be Updated | |
Not Live / Waiting for Review | √ | ||||
Ready / Reviewed | √ | ||||
Ready / Not Reviewed | √ | ||||
Live / Reviewed | √ | ||||
Live / Not Reviewed | √ |
Parental Advisory for Songs and Booklets |
|---|
Pass-Through | Ticket Optional | Create Ticket | Ticket Required | Cannot Be Updated | |
Not Live / Waiting for Review | √ | ||||
Ready / Reviewed | √ | ||||
Ready / Not Reviewed | √ | ||||
Live / Reviewed | √ | ||||
Live / Not Reviewed | √ |
Audio Files |
|---|
Note: This change is applied only if the checksum of the new audio differs from the checksum of the audio currently in the iTunes database. |
Pass-Through | Ticket Optional | Create Ticket | Ticket Required | Cannot Be Updated | |
Not Live / Waiting for Review | √ | ||||
Ready / Reviewed | √ | ||||
Ready / Not Reviewed | √ | ||||
Live / Reviewed | √ | ||||
Live / Not Reviewed | √ |
Booklet Files |
|---|
Note: This change is applied only if the checksum of the new file differs from the checksum of the booklet currently in the iTunes database. |
Pass-Through | Ticket Optional | Create Ticket | Ticket Required | Cannot Be Updated | |
Not Live / Waiting for Review | √ | ||||
Ready / Reviewed | √ | ||||
Ready / Not Reviewed | √ | ||||
Live / Reviewed | √ | ||||
Live / Not Reviewed | √ |
|