IMPORTANT: You must be part of the Matter Private Beta Program to start developing Matter devices and apps in the Google Home Developer Console. Apply now

Test your Matter integration

The Google Home Developer Console provides a Test page where you can configure and run tests against your Matter integration using the Google Home Test Suite.

The Test Suite can be run on a set of devices that belong to a specific Matter project configuration. It is very important to run the Test Suite on your integration(s) to ensure that everything is working properly.

On the Test page, Matter integrations that are complete and ready to test are listed under Ready.

Matter integrations that have been tested are listed under Tested.

Type of test plans

There are two types of test plans:

  • Development test plans are used to test controlling devices using Matter. They are editable, but cannot be submitted for Matter certification.

  • Certification test plans are specifically for Matter certification, and are not editable.

Set up your tests

Go to the Developer Console

  1. From the list of projects, click Open next to the project you want to work with.

  2. In the navigation menu on the left side of the page, go to Matter > Test.

  3. On the same row as the integration you intend to test, click Test.

  4. Provide a name for your test.

    Creating a new test plan

  5. Select Development for the Test Plan Type, then select the devices you wish to test from the list of devices.


    Select Certification for the Test Plan Type.

  6. Click the Next: Test Plan button.

  7. On the next page, titled Create a test plan, select the Test Suites you want to run. For each Test Suite, select Manual mode (automated tests are not yet supported).

  8. Create a test plan

    You may now run your tests or click Return to Developer Center.

    Run your tests

    In the Test Suite, from the Create a test plan page, click Run Test.

    View and interpret your test results

    Your test results appear once the tests complete.

    The status of each test suite execution appears next to it (Passed, Failed).

    The Logs pane shows the status of each individual test execution.

    Test results

    You may view previous test results for a development plan or an unsubmitted certification test plan by clicking Retest from the upper table to go to the Test Environment page which displays the previous test results.

    For a submitted certification plan, click Result in the lower table to view the test results report.