Alexa Presentation Language Known Issues


Refer to the following list of known issues, bugs, and breaking changes for Alexa Presentation Language (APL).

Known issues

  • The widget visual context doesn't populate when the user invokes the skill by voice.

  • User interface issue in the Multimodal Response Builder: After you navigate to the Integrate response into skill page, clicking the Multimodal Responses item in the developer console sidebar doesn't navigate you to the Multimodal Responses page. To work around this issue, click Interfaces in the sidebar first, then click Multimodal Responses.

  • VectorGraphic linear gradient looks different between the Authoring tool and Physical devices

  • [Tablets] AlexaImageList: Disabled List Item behavior is broken on Portrait 10 inches devices

  • On physical devices, when a Frame contains an Image component, the borderRadius property for the Frame doesn't properly adjust the Frame corners

  • [Fire TV Editions TVs] Recipe video doesn't revert to the original volume after dismissing the volume panel

  • Word break opportunity before <nobr> tag not breaking correctly

  • Text with <nobr> incorrectly wrapping at the end of a container

  • [APL Simulator] [Large Hub/Extra Large TV Hub] Videos are not playing for both autoplay false and true scenarios

  • APL documents that use the Video component to play audio by settings its width/height to 0 will stop working. To work around this issue set the width/height to 1

Breaking Changes

  • [APL 1.6] Echo Show 8 is now a Hub Landscape Medium device. Customer feedback on the Echo Show 8 indicated that the font size was too small on many Alexa experiences. To address this, we've updated how the device reports it's screen size, which results in the device being classified as a Hub Landscape Medium device instead of a Hub Landscape Large. To account for this change, we recommend you review the Interfaces page in the Alexa developer console and ensure you have Hub Landscape Medium checked, as well as all the boxes for any other viewports that you support. Existing skills will not be impacted. They will continue to see Echo Show 8 as a Hub Landscape Large device until they check the box to opt in to Hub Landscape Medium as a supported viewport profile.

  • [APL 1.6] On FireTV directional keys no longer cause Pagers to animate in APL documents with version <1.6. To mitigate, change the APL document version to 1.6.

  • [APL 1.6] On an Alexa-enabled device with a screen, the viewport is the area of the screen that the user can see. A viewport has a shape, orientation, size, and density. In that, size and density are defined as ranges so that the profile can represent multiple physical devices. When you manually provide fixed/legacy viewport dimension values instead of the currently supported viewport ranges in the skill manifest for Hub Round Small, Hub Landscape Small, Hub Landscape Medium, and Hub Landscape Large devices, the corresponding viewport profile checkboxes aren't checked in the developer console. The current best practice is to verify whether your APL content renders correctly on the required viewport profiles, and then select the corresponding viewport profiles in the console or provide the corresponding supported viewport ranges manually in the skill manifest.

  • [APL 1.7] AVG radial gradients no longer render with incorrect radius, positioning, or scaling on Android devices


For support and help, visit the Alexa developer forum. Go to Contact Us to report an issue.


Last updated: Jul 20, 2022