How to upload Poster Images for media items
Overview
This article explains how to upload and select Poster Images for media items in a VOD or AOD Channel playlist in the Media Cloud.
Poster Images are vertical thumbnail images that can be used in supported apps to display on-demand content in a 2:3 poster-style layout.
When to use Poster Images
Use Poster Images when you want video or audio items in an on-demand Channel playlist to display with vertical 2:3 images instead of standard 16:9 thumbnails in supported apps.
Poster Images are commonly used for series artwork, movie artwork, vertical video content, or other on-demand content that should appear in a taller gallery-style layout.
Before enabling Poster Images for a Channel, make sure each media item in the playlist has an uploaded or AI-generated Poster Image selected. When a Channel is configured to use 2:3 Poster Images, the app expects every media item in that row to use Poster Images instead of standard 16:9 thumbnails. This helps provide a consistent appearance across supported apps.
How it works
Poster Image format and size
Poster Images are uploaded separately from standard thumbnails and use a vertical 2:3 image format instead of the standard horizontal 16:9 format.
The recommended minimum Poster Image size is 640 x 960 px.
Poster Images can be uploaded manually or generated using AI in the Media Cloud.
Media Poster Images and app rows
There are two types of Poster Images:
Media Poster Images, which are uploaded to individual video or audio items and are typically displayed in content rows
Channel Poster Images, which are uploaded to the Channel itself and may be used in Channel Group Rows, depending on the app configuration
For media items in a Channel playlist, the selected Poster Images are used when that Channel is configured to display 2:3 Poster Images. In the App Builder, the Video Image Type setting controls whether supported app rows display media items with standard 16:9 Thumbnails or 2:3 Poster Images.
Poster Images display only in supported apps that are configured to use 2:3 Poster Images for the Channel. If your app has not been updated to a framework that supports Poster Images, the option may not be available in the App Builder. Contact Customer Support for assistance.
If an app is configured to use 2:3 Poster Images but a media item does not have a Poster Image selected, the app may display a placeholder image instead of the intended artwork.
Selecting a Poster Image
The Media Cloud includes a Poster Image Selector that allows you to choose which Poster Image is used for an individual video or audio item.
From the media item's IMAGES tab, select POSTER IMAGE and click SELECT POSTER to choose from available images, including:
Manually uploaded Poster Images
AI-generated Poster Images
The SELECT POSTER option appears only when an uploaded or AI-generated Poster Image exists for that media item.
You can change the selected Poster Image whenever another available image better represents your content.
Sub-Channels and Media Groups
The Video Image Type setting is shown in the App Builder when the app framework supports Poster Images and the Channel is configured to display media items directly in the app row.
A Channel can have Sub-Channels in the Media Cloud and still use Poster Images in an app, as long as Sub-Channels are not enabled for that Channel in that app’s App Builder settings.
If Sub-Channels or Media Groups are enabled under Sub-Category for that Channel in the App Builder, the Video Image Type setting is not shown, and the app uses standard 16:9 thumbnails for that Channel row.
If a Channel is already configured to use 2:3 Poster Images and Sub-Channels are later enabled for that Channel in the App Builder, the system automatically switches the Channel row back to standard 16:9 thumbnails.
To learn how to enable Poster Images for a supported app, see How to enable Poster Images in the App Builder.
Channel Poster Images and custom galleries
A Channel can also have its own Poster Image, which is uploaded from the Channel's IMAGES tab under POSTER IMAGE. The Channel Poster Image is separate from the Poster Images uploaded or generated for individual media items in the playlist.
Channel Poster Images can also be used in apps that display VOD or AOD Channel Group Rows. If you want Channel Poster Images to display in a Channel Group Row, contact Customer Support to have this feature enabled for your app. A setup fee may apply.
Poster Images can also be used by developers when building custom website galleries with the LightcastAPI and developer tools.
Instructions
How to upload Poster Images for media items in the Channel's Playlist
Step 1
Log in to your Media Cloud account.
Step 2
Under CHANNELS, select Video On-Demand or Audio On-Demand, depending on the Channel you want to update.
Step 3
Select the VOD or AOD Channel that contains the media items that need Poster Images.
Step 4
Select the PLAYLIST tab.
Step 5
Open the video or audio item that needs a Poster Image.
Step 6
Select the IMAGES tab.
Step 7
Select the POSTER IMAGE tab.
Step 8
Click UPLOAD IMAGE to upload a vertical image with a 2:3 aspect ratio.
For best results, use an image that is at least 640 x 960 px. The image should be clear, high-quality, and easy to read across different screen sizes.
Step 9
Repeat these steps for each media item in the same VOD or AOD Channel playlist.
To create a consistent Poster Image row in your apps, each media item in the playlist should have its own Poster Image.
Step 10
After the Poster Images are uploaded, make sure the Video Image Type setting is configured to use 2:3 Poster Images in the App Builder for each supported app where you want videos from the Channel to display in a Poster Image row.
For step-by-step instructions, see How to enable Poster Images in the App Builder.
How to upload Poster Images for media items from the Video or Audio Archive
Step 1
Log in to your Media Cloud account.
Step 2
In the main menu, go to MEDIA and select Video Archive or Audio Archive, depending on the media item you want to update.
Step 3
Open the video or audio item that needs a Poster Image.
Step 4
Select the IMAGES tab.
Step 5
Select the POSTER IMAGE tab.
Step 6
Click UPLOAD IMAGE to upload a vertical image with a 2:3 aspect ratio.
For best results, use an image that is at least 640 x 960 px. The image should be clear, high-quality, and easy to read across different screen sizes.
Step 7
Repeat these steps for each media item that should display in a Poster Image row.
How to select a Poster Image for a media item
Use these steps to choose between available uploaded and AI-generated Poster Images for an individual video or audio item.
Step 1
Open the video or audio item in the Media Cloud.
Step 2
Select the IMAGES tab.
Step 3
Select the POSTER IMAGE tab.
Step 4
Click SELECT POSTER.
This option appears when at least one uploaded or AI-generated Poster Image is available for the media item.
Step 5
In the Select a Poster Image window, choose the uploaded or AI-generated Poster Image you want to use.
You can also enlarge the thumbnail previews to review the images more closely before making your selection.
Step 6
Click SAVE to update the Poster Image.
The selected Poster Image will be used when the media item appears in a supported app row configured to display 2:3 Poster Images.
How to upload the Channel Poster Image
Channel Poster Images are separate from the Poster Images uploaded or generated for individual media items. They may be used for VOD or AOD Channel Group Rows or by developers building custom galleries with the LightcastAPI and developer tools.
Step 1
Under CHANNELS, select Video On-Demand or Audio On-Demand, depending on the Channel you want to update.
Step 2
Select the VOD or AOD Channel that needs a Channel Poster Image.
Step 3
Select the IMAGES tab.
Step 4
Select the POSTER IMAGE tab.
Step 5
Click UPLOAD IMAGE to upload a vertical image with a 2:3 aspect ratio.
For best results, use an image that is at least 640 x 960 px. The image should be clear, high-quality, and easy to read across different screen sizes.
FAQs
What image size should be used for Poster Images?
Poster Images should use a 2:3 aspect ratio. The recommended minimum size is 640 x 960 px.
Can Poster Images be used for both video and audio content?
Yes. Poster Images can be uploaded for both video and audio items in the Media Cloud.
Can Poster Images be generated using AI?
Yes. The Media Cloud supports both automatic and manual AI Poster Image generation for video and audio items.
Automatic generation can be enabled through MEDIA → Media Settings under AI Generated Images. You can also generate a Poster Image manually by opening a media item and selecting IMAGES → POSTER IMAGE → GENERATE AI POSTER.
Manual AI generation requires a title, description, and an existing 16:9 thumbnail for the media item. Each media item can have up to three AI-generated Poster Images, including automatically generated images.
AI image generation does not use AI Tokens.
How can a different Poster Image be selected for a media item?
Open the media item and select IMAGES → POSTER IMAGE → SELECT POSTER.
Choose the uploaded or AI-generated Poster Image you want to use and save your selection.
Why is the SELECT POSTER option not available?
The SELECT POSTER option appears only when at least one uploaded or AI-generated Poster Image exists for the media item.
Upload or generate a Poster Image first to make the selector available.
Do all media items in the Channel playlist need Poster Images?
Yes, this is recommended. When a Channel is configured to use 2:3 Poster Images, each media item in the playlist should have an uploaded or AI-generated Poster Image selected so the row displays consistently across supported apps.
What happens if Poster Images are enabled but a media item does not have a Poster Image?
If an app is configured to use 2:3 Poster Images but a media item does not have a Poster Image, the app may display a placeholder image.
What happens if Sub-Channels are enabled after Poster Images are already enabled?
If Sub-Channels are enabled for that Channel in the App Builder, the system automatically switches the Channel row back to standard 16:9 thumbnails. The Video Image Type setting is not shown while Sub-Channels are enabled for that Channel row.
Poster Image support for Sub-Channel rows is planned for a future phase.
Why are Poster Images not showing in an app?
Poster Images must be uploaded or generated and selected for the media items, and the app must be configured to use 2:3 Poster Images for the Channel.
The app must also use a framework that supports Poster Images. If the option is not available in App Builder, contact Customer Support for assistance.
Does the Channel need its own Poster Image?
For most app rows, the Poster Images uploaded to the individual media items are the images that display in the row.
The Channel Poster Image is separate. It may be used in apps that display VOD or AOD Channel Group Rows. If you want Channel Poster Images to display in a Channel Group Row, contact Customer Support so we can enable Channel Group Rows for your app. A setup fee may apply.
Can developers use Poster Images with the LightcastAPI?
Yes. Developers can use Poster Images to build custom website galleries with the LightcastAPI and developer tools.























