Action Required! Starting November 21st, 2022, Nest Hubs opted into the Preview Program are being updated to support Matter 1.0 in anticipation of Google's general availability (GA) of Matter. All Matter devices being used with the Preview Program will need to be updated. See the Release Notes for more details.

Test your Matter integration

Stay organized with collections Save and categorize content based on your preferences.

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.


    If you preparing for certification in the Google ecosystem, 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.