Alexa Presentation Language Known Issues


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

Known issues

  • On the Echo Show 5 (3rd Gen, 2023 release) device, the environment.aplVersion property reports 2023.1 even when the device has 2023.2.
    • The features released with 2023.2 work on the device.
    • However, an expression such as ${environment.aplVersion == '2023.2'} returns false on these devices. Therefore, if you use when to provide different experiences for different versions of APL, these devices behave as a 2023.1 device until this issue is addressed.
  • [Tooling] The Smart Motion Simulator in the developer console isn't properly loading the APL Smart-Motion Extension and APL Entity-Sensing Extension. These extensions do continue to work with supported physical devices.

  • [Video] In the authoring tool, when you preview a Video component that has multiple videos in the source array, the audio for the video continues to play after you exit preview mode.

  • [Response Builder] In the multimodal response builder, when you preview the "Audio" template and then navigate to the next step in the workflow, the audio continues to play.

  • 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, and 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 aren't playing for both autoplay false and true scenarios.

  • APL documents that use the Video component to play audio by setting thewidth and height properties to 0 don't work. To work around this issue set the width/height to 1.

Breaking changes

  • [APL 2023.2] APL-generated JSON now serializes numeric values as integers when appropriate. Previously APL serialized all numeric values as floating point. For example, a SendEvent command that passes the value 5 serializes this value as "5" instead of "5.0". This affects all JSON structures serialized by the APL core library, including user events, dynamic data requests, visual context and extension messages.

  • [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, Amazon 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, review the Interfaces page in the Alexa developer console and make sure that you have Hub Landscape Medium checked, as well as all the boxes for any other viewports that you support. Existing skills aren't impacted. Existing skills continue to see Echo Show 8 as a Hub Landscape Large device until you 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] Alexa Vector Graphic (AVG) radial gradients no longer render with incorrect radius, positioning, or scaling on Android devices


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


Was this page helpful?

Last updated: Jun 30, 2023