as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
AWS
Documentation
Support
Contact Us
My Cases
Get Started
Design and Develop
Publish
Reference
Support

Recommendation2

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 updated: Sep 30, 2025