The Batch items tab within Updates history allows the user to see the specific updates that are being delivered. Depending on how the user filters this tab, they may observe all relevant batch items or batch items specific to a batch.
The article will cover various topics regarding Batch items:
Navigating
The user can see that they are in the Batch Items tab, with the directory guidance below the Module's name or the white tab of the same name.
At the top of the Batch items tab, along with the other tabs, are the Columns, Download, and Filter buttons.
- For information on the unique columns available in the Batch Items tab, scroll further down or click here.
- For more information on the Columns button and showing or hiding columns, click here.
- For instructions on exporting updates history results, click here.
- For more information on utilizing the filters, click here.
In Updates History, the "Batch items" tab can be accessed in two ways:
- Clicking on the name of the Batch in the "Batches" tab:
- Or, while within the "Batch items" tab, searching for the name of the batch (if known) or drilling deeper into the information that batch should have delivered to platform by utilizing the Filters on the right-hand side of the UI. For more information on how to utilize the filters, click here.
Within "Batch items", the user can see the information that includes the title, retailer, pricing, status of the update, and more under their relevant headers.
Batch Item Data
Without filtering Batch items tab, the user will see all batch items regardless of status. The data covered in Batch items dives into specific data that should be delivered to platform or utilized by Storefront to manage delivery.
Table Columns
The "Columns" button in the upper-right of the UI allows the user to choose their column headings.
Within Batch Items, users have the option of utilizing column headers that they may choose to hide or show. Please note, the more columns, the longer the table may take to load.
- For more information on how to show or hide columns, please click here.
The following is a list of unique columns utilized by Batch Items:
General Data
-
Retailer - The retail platform, the data will be delivered to.
- At this time, iTunes is the only platform users may deliver to through Storefront.
- Retailer ID - The retail platform's unique ID that represents the Title.
- Vendor ID - The Provider/Vendor's unique ID that represents the corresponding title.
-
Content type - The type of program being delivered.
- Please note that, at this time, Movies and TV Seasons can be delivered. Depending on the type, it may exist within a separate workflow and may not have the same automations that are provided to the other.
-
Live rating - The rating that will be displayed on the retail platform.
- Certain territories may not require this information. Please refer to the platform's data requirements for this information.
- Live genre - The genre for the item as displayed on the retail platform.
-
Territory - This represents the particular area or region of a title for which the batch updates have occurred.
-
Status - The current status of
-
-
- Delivering - The update is still being pushed through.
- Error - The update did not successfully go through. When specific batch item fails to deliver for a title, a corresponding error message will appear here if the user clicks on the red error button. This option is only available in Batch items (e.g., "Invalid HDBUY Price")
- For information on Update Errors, please click here.
- Faked - The update has been duplicated
- Pending - The update has been pending for a while
- Success - The update successfully went through
- Success/Unverified - The update has yet to be verified
- Draft - The update has been saved as a draft, and not gone through.
-
-
- Delivered files - a link to the XML file containing the metadata that was sent through for this update.
Fields under the following headers (Pricing, EST, VOD, and Other) apply to iTC's metadata values, corresponding to pricing information for specific formats or ranges. The price values correspond to the specific batch item on the same row.
Pricing
- HD/UHD price - HD or Ultra HD price for EST (Electronic Sell-Through) on platform.
- SD price - Standard Definition price for EST (Electronic Sell-Through) on platform.
- HD/UHD VOD price - HD or Ultra HD price for VOD (Video on Demand)
- SD VOD price - Standard Definition price for VOD on platform.
-
Price date range - The range given for when the entire title/territory's prices will be available and end.
- Represented as a Sales Start Date (06/02/2025) and End Date that can either be set to No End Date in Create Updates, or set to a specific end date in the same format.
- This range does not align to a specific price, but instead manages the entirety of when the title will be available on store. EST/VOD Date Ranges specified can not be outside this range as they reference specific ranges of the price offers provided above.
- Represented as a Sales Start Date (06/02/2025) and End Date that can either be set to No End Date in Create Updates, or set to a specific end date in the same format.
EST
- Cleared for sale - Specifies if this video can be sold for EST sale in the product’s territory.
- EST date range - The given date range set to begin and end the EST offer.
-
Allow pre-order - Allowing the title and territory to be available for a pre-order price that's given.
- This option works in conjunction with the Pre-Order start date, and the proper price tier for a premium orders in the given avail data.
-
Pre-order start date - The start date of the pre-order offer on store.
- The pre-order date must be before the sales start date (Price Date Range)
- Enable EST HD - Specifies if the video is cleared for HD EST sale in the product’s territory.
VOD
- Cleared for VOD - A setting that allows the VOD offers to be live on store once they're set start dates occur. A title's VOD offers can be cleared for sale, but not start until a later date.
- VOD date range - The given date range set to begin and end the VOD offer.
- Enable VOD HD - Specifies if the video is cleared for HD VOD sale in the product’s territory.
Other
- Rating - The viewer rating value that is necessary for the title and regulated by that territory (i.e., for the U.S. - "PG-13")
- Rating reason - For certain territories, ITC and the territory's governing body that regulates TV/Film ratings will require designated reasons listed on store. Generally provided like so: "for drug content, some sensuality and war violence"
- Advisories - Corresponding with the rating Reason, the user will be expected to provide the proper Advisory Name for the store. (i.e., for South Korea "Violence", "Nudity", etc.)
- Rating classification -
- Physical release date - The date standard physical sales for the title are to release
- HD physical release date - The date High-Definition physical sales for the title are to release
- Watermark end date - On platform, iTC provides watermarks to prevent piracy. This designates the date watermarking should end.
-
Burned in subtitles end date - Indicates when the burned-in subtitles used for content protection should be removed from the film.
- Please note, that the platform also assumes that your organization will also supply full subtitles according to their guidance.
- Suppression lift date - Indicates the date when the release date should no longer be suppressed on platform.
Actions
-
Re-update: This option allows users to create a new update utilizing the data previously provided in the batch or from a batch item.
- If the user wishes to send specific items from batch items, they can check the boxes next to any of the updates, the box next to "Batch name".
- Then, click the "Re-update selected" button to send them through again.
- Please note the following:
- If the update has an error status, the user should verify that the error has been resolved before attempting to re-update.
- Additionally, in certain cases, the update may be resent thanks to automated workflows. Please contact support to clarify these cases.
- Please note the following:
- From there, the user will be redirected to the Create Updates module and the data will be pre-filled with the previous batch item's data.
- For more information on creating updates, click here.
-
Cancel: This option allows for users to only cancel pending batches in Updates History that don't have the delivering status, yet. Otherwise, it will be grayed out.
- Users can select the batch, which will redirect them to Batch Items. In Batch Items, users should check any given items they'd like to cancel, and then they can navigate to the Actions menu.
- Within this menu, users will find the Cancel updates function. Upon selecting Cancel updates, a confirmation window will open.
- Users can either select 'Cancel' or 'Ok', which would then remove that update's batch item(s).
- Any selected batch items should be listed here. Users can either select 'Cancel' or 'Ok', which would then remove that update's batch item(s).
- Canceling an update in Storefront does not guarantee the update will not be delivered if it wasn't canceled in a timely fashion. Users must validate their data prior to sending the update, or risk unintended changes.