Test and Debug Your Skill

The Alexa Skills Kit (ASK) includes tools to help you test and debug your skill. The types of testing that you do depends on the voice interaction model for your skill type.

Use the following guides to help you learn how to test and debug an Alexa skill:

Before you publish your skill, you can beta test the skill with a small group of friendly users.

Test for the voice interaction model

The following table shows the most widely used test tools for the pre-built and custom voice interaction models.

Tool Prebuilt Custom

Alexa simulator in the Alexa developer console

Alexa simulator in Visual Studio Code

ASK Command Line Interface (CLI) test tools`

Automatic Speech Recognition (ASR) evaluation tool

Find utterance conflicts

Utterance profiler

Natural Language Understanding (NLU) evaluation tool

Smart Home debugger

Smart Home test tools for automated testing

Skill Management REST API for automated testing

Alexa app for Android and iOS

Alexa-enabled device

Test your skill with the Alexa app

You can use the Alexa app installed on your desktop or your iOS or Android mobile device to test your skill .

Make sure that the locale of your Alexa app matches at least one of the locales available for your skill. For example, if your skill has the en-US locale, set your Alexa app to English (United States).

To set the locale for your Alexa app

  1. Open the Alexa app on your mobile device.
  2. Navigate to More > Settings > Alexa on This Phone.
  3. Set the language under Language to the locale for your skill.

Test your skill on an Alexa-enabled device

To test your skill with an Alexa-enabled device, such as an Amazon Echo, register the device with the same email address that you used to sign up for your developer account on the Amazon developer portal. Make sure that the locale of your device matches at least one of the locales available for your skill. Then, you can invoke your skill with the wake word and your invocation name: "Alexa, open invocation name."

If you configure your device with an account other than your developer account, reset the device, and then re-register it with your developer account. For details, see the help for your specific device:

If you want to add a non-developer account as a user of the device, you can use the Household feature or start a beta test.

Test your skills behind a firewall

If you develop your Alexa skills in a corporate environment, you must open ports on your corporate firewall to allow developers to connect Amazon Echo devices to the corporate network for testing. In addition, to use Echo devices on your network, you must create a consumer Wi-Fi network within your corporate environment. At this time, Echo devices don't support enterprise networks directly.

Open the following ports on your corporate firewall:

  • Input TCP – 8080, 443, 40317
  • Input UDP – 53, 67, 68, 1900, 50000, 5353, 33434, 49317, 40317
  • Output TCP – *, 80, 8080, 443, 40317, 67, 68
  • Output UDP – *, 53, 123, 40317, 49317, 33434, 1900, 5000, 5353

Additional resources

Use the following additional resources to help you learn how to test an Alexa skill.

Blog posts


Was this page helpful?

Last updated: Nov 23, 2023