Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
Ring
AWS
Documentation
Support
Contact Us
My Cases
Get Started
Design and Develop
Publish
Reference
Support
Skip to main content
Recommendation2: Omit<Recommendation, "contentImage"> & object & Required<{ contentImageUri: URL; } | { contentImage: number[]; }> Represents a recommendation displayed on the device home screen. Supports content images via either URI or byte array format.
Image Handling
  • Requires exactly one image source:
    • contentImageUri: URI reference to image
    • contentImage: Direct byte array of image data
  • If both sources are provided, byte array takes precedence
  • Missing both sources triggers InvalidArgumentError
Requirements:
  • Text must be concise for UI optimization
  • All string content must use UTF-8 encoding
  • Size limit: 512KB per recommendation (excluding the contentImage, if provided)

Type declaration

contentImage?

optional contentImage: number[] Image (PNG) to be displayed for this recommendation, recommendations without images or incorrect specs will not be displayed. This is a required field. Use the following specifications for the image: Aspect ratio: 16:9 Channels : 3 (BGR) with 8 bit/channel Orientation : Landscape Format : PNG Depending on display the image resolution should be : HDTV (720p) : 256 _ 144 . HDTV (1080p): 384 _ 216 4K UHD : 768 * 432 Title: Embedded within image Transparency: No transparency

contentImageUri?

optional contentImageUri: URL URI of the recommendation’s display image. Must meet specified requirements for proper display. Image Requirements:
  • Aspect ratio: 16:9
  • Orientation: Landscape
  • Title: Must be embedded within image
  • Transparency: Not supported
Note: Non-compliant images will either:
  • Not be displayed, or
  • Be replaced with a default placeholder image

Last modified on October 2, 2025