Use the Smart Home Test Tool
Use the Smart Home Test tool in the Alexa developer console to verify that you implemented the Alexa interfaces correctly in your smart home add-on. The automated tests send directives to your add-on and verify that you set the state correctly. By using the Smart Home Test tool, you can verify that you implemented the Alexa interfaces in your add-on correctly.
The Smart Home Test tool provides automated tests for the following Alexa interfaces: BrightnessController, ColorController, ColorTemperatureController, PowerController, ThermostatController.
For details about other test tools, see Test and Debug Your Smart Home Add-on. To invoke the Smart Home Test tool by using REST, see Smart Home Evaluation REST API.
Test in the Alexa developer console
You run the Smart Home tests on the Test tab in the Alexa developer console. Each Smart Home Test sends directives to your add-on, and then compares the expected device state with the actual device state. You can see the results of your tests in the console. If you want to see the contents of each test, you can download them from the developer console.
You can run the Smart Home Tests on your smart home add-on before you submit it for certification to reduce the potential for errors during certification. A successful Smart Home Test result doesn't guarantee certification. For more details about certification, see Smart Home and Video Certification Guide and Works with Alexa Overview.
The following image shows the Smart Home Test page in the developer console for a smart home add-on that controls a color bulb.
Run tests
Use the following procedure to run a new test on your smart home add-on.
To run a test on your add-on in the Alexa developer console
- Sign in to the Alexa developer console.
- On the Skills tab, under SKILL NAME, find your smart home add-on.
- Under ACTIONS, expand the dropdown list in your add-on's row, and then select Test.
- On the Test page, select Smart Home Test.
- For Device, choose the device that you want to test with your add-on.
- For Capabilities, choose one or more Alexa interfaces that you want to test. You can choose more than one interface for each test. Some interfaces require additional information. For example, if you choose the Alexa.ThermostatController, you also choose Celsius or Fahrenheit for the temperature scale.
- Choose Run Test.
Test status
While a test is running, the status appears as In Progress. After a test completes, the status appears as Passed, Failed, or Error.
The following are the possible statuses:
- In Progress – The test is running.
- Passed – The test completed, and all test cases were successful.
- Failed – The test completed, and one or more test cases were unsuccessful.
- Error – The test wasn't run. For example, due to the test device not plugged in.
Manage tests
All your tests appear in the Test Results section of the Test page. You can expand each test result row to see the details for the test. Test results remain in the Test Results section for 30 days.
Use the menus that precede the test results to filter the results. You can filter the results by device, interface, status, and age of the test.
Use the menu in the ACTIONS column to manage your test results. From the ACTIONS menu, you can do the following:
- New run – Rerun a previous test with the same options. For example, rerun a failed test after updating your code.
- Download test results – Download the details of the test including the expected states and actual states.
- Download test cases – Download the details of the test cases for the test.
Related topics
- About the Automated Testing Service
- Steps to Build Smart Home Add-ons
- Test and Debug Your Smart Home Add-on
- Smart Home Evaluation REST API Reference
Last updated: May 13, 2026
