Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
Ring
AWS
Documentation
Support
Contact Us
My Cases
Develop
Test
Publish
Monetize
Engage users
Device specifications
Resources
Skip to main content
Fire TV devices render your app’s UI on a 1080p or 720p UI canvas, at a screen density that depends on the device. To render well on a TV, your layouts must account for screen resolution, density, and density-independent pixels (dp). This document provides technical information for building your UI layouts on Amazon Fire TV devices. See Design and User Experience Guidelines for general guidelines on TV design.

Screen size and resolution

Many Android devices, such as Fire tablets, have a fixed physical size and a single resolution. This isn’t the case with Amazon Fire TV devices, to which you can connect a 720p or 1080p screen of any size. To keep your layouts the same size at any resolution, specify dimensions in dp instead of pixels. The following table shows the size, screen density, and display resolution in dp of each UI canvas on Fire TV devices.
UI canvasCanvas size (pixels)Density identifierDisplay resolution (dp)Screen size identifier
1080p1920 x 1080xhdpi (320)960 x 540large
720p1280 x 720tvdpi (213)~960 x 540large
The device sets the UI canvas, which is the surface your app’s UI renders to. The UI canvas can differ from the output resolution of the connected TV. Because Android scales dp units to match each canvas density, the display resolution is about 960 x 540 dp on every canvas. If you build your layouts in dp, they render the same on every Fire TV device and need no per-device changes.

Orientation

The orientation of the Amazon Fire TV device never changes, and requests for the rotation or orientation on the device return these results:
MethodResult
Display.getRotation()0 (ROTATION_0)
Display.getOrientation() (deprecated)0 (ORIENTATION_UNDEFINED)

Resource configurations

If you design your app to run on devices other than Amazon Fire TV, such as tablets, you can create different layouts and drawables for each device type, and store them in subdirectories of res/ named for various device configurations. For more information on using these resource configurations, see the Android Screen compatibility overview. The following table describes the resource configurations available on Amazon Fire TV devices.
ConfigurationValue
Smallest widthsw540dp
Available widthw960dp
Available heighth540dp
Screen sizelarge
Screen aspectlong
Screen orientationland (TV apps are always landscape)
UI modetelevision
Night modenotnight
Screen pixel densityxhdpi (1080p UI canvas) or tvdpi (720p UI canvas)
Touchscreen typenotouch
Keyboard availabilitykeyssoft
Primary text input methodnokeys
Navigation key availabilitynavexposed
Primary non-touch navigation methoddpad
Platform versionv17

Layout best practices

Follow these practices so that your app renders correctly on every UI canvas:
  • Size your UI in dp, not px. Don’t hardcode 1920 x 1080 or other pixel values in your layouts or code.
  • Get the screen size from the window. Use WindowMetrics (API level 30 and higher), Resources.getDisplayMetrics(), or Configuration. Don’t use Display.Mode, which reports the resolution of the TV panel, not the UI canvas.
  • Don’t gate layouts or assets on a density threshold. For example, a check such as densityDpi >= 320 fails on a tvdpi canvas. Use resource qualifiers or dp-based sizes instead.
  • Request and decode images at their displayed size. Calculate the pixel size from the current density (dp × DisplayMetrics.density), and include any zoom applied on focus. Don’t request images at a fixed 1080p pixel size.
The following example reads the UI canvas size from the window and converts a dp size to pixels for an image request:
Last modified on October 30, 2026