Set up branding for a Matter integration

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

The discovery and setup process presents the first opportunity for your brand to engage directly with your users. The Matter branding page provides a way to embed your brand's unique identity into this interaction.

Go to the Developer Console

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

  2. Go to Matter > Develop.

  3. Click Edit next to your chosen integration.

  4. On the Matter setup screen, click Save & continue to go to the Configure setup and branding (optional) page.

The Configure setup and branding (optional)
page

Upload product images

Product images help users recognize your device when setting it up in the Google Home app (GHA) . If you choose not to provide images, your device is represented by the Matter logo.

You can upload two images—one showing the device turned off, and one showing the device turned on.

  • The 'off' image appears during Fast Pair, representing the device prior to setup.

  • The 'on' image appears after the user completes setup and has named the paired device, representing the device after setup.

To provide your own product images:

  1. Click Upload product images.

  2. In the Upload pre-setup image dialog, delete the 'off' placeholder Matter logo by clicking the close button in the upper-right, which causes the Upload button and image requirements to appear.

  3. Click Upload and select a 720x720px PNG image. After the image uploads successfully, click Next.

  4. On the Upload post-setup image (optional) dialog, upload an 'on' image, following the same steps you just took to upload your 'off' image.

  5. Click Save to save your changes, or Cancel to leave the existing images in place.

Provide identifying information

Tools required for this task

Under App Info, you may provide a unique identifier for your Android app if it is available on the Play Store and has implemented the Home Mobile SDK for commissioning and sharing of devices. When pairing your device, this gives the user the option to switch to your app to complete pairing, instead of using the GHA.

If your app has not implemented these APIs, you should leave this field blank.

This identifier should match the package that appears in the AndroidManifest.xml.

When you're satisfied with your entry, click Save. The message Matter device branding and setup configured appears, and you are returned to the Develop page.

Your changes go into effect immediately upon saving.

Edit branding

To modify the branding on your Matter integration:

  1. Go to Matter > Develop.
  2. Click Edit next to your chosen integration.
  3. On the Matter setup screen, click Save & continue to go to the Configure setup and branding (optional) page.

To replace the product images:

  1. Click Edit product images.
  2. Delete an image by clicking the close button in the upper-right, which causes the Upload button and image requirements to appear.

  3. To replace the 'off' image, click Upload and select a new 'off' image. After the image uploads successfully, then click Next. Or just click Next to skip replacing this image.

  4. On the Upload post-setup image (optional) dialog, you may upload a new 'on' image.

  5. Click Save to save your changes, or Cancel to leave the existing images in place.

To change the Android package, simply edit the Android package name field.

When you're done making changes, click Save. The message Matter device branding and setup configured appears, and you are returned to the Develop page.