FAQ: What do I need to add a Matter device to the SmartThings app? Do I need a bridge router device?

My question is if the SmartThings application can communicate with Matter devices (Thread, Wifi or Ethernet) or is a bridge router necessary?

It depends on the details.

1) you must have a SmartThings hub/dongle which can act as a “Matter Controller.” right now the choices are a SmartThings V2 hub, a SmartThings V3 hub, an Aeotec hub, the SmartThings Station, or the dongle that can be added to the Family Hub refrigerator. They continue to add more options to this list. You cannot use matter devices with only the smartthings app: you have to have a “Matter controller” hub/dongle as well.

2) you must have the SmartThings app on an iOS or android device to act as a “matter commissioner.“ At the time of this writing, the official web interface could not perform this function.

If you have a Samsung galaxy phone, it has some additional matter options that other choices do not have, but nothing particularly important.

3) If the device you want to add is individually certified for Matter over Wi-Fi such as the Leviton D215p smart plug, then that’s all you need as long as your Wi-Fi router either supports IPv6 addresses or can spoof them. (Matter-certified devices using Ethernet instead of WiFi also need to support IPv6 addresses.) Just make sure the device you want to add is on the same Wi-Fi/LAN network as the controller and commissioner devices in one and two above, and you should be able to add it, although the exact steps will depend on whether you have previously added it to a different matter controller or not.

Note: if you are in the United States, you use one of the major Internet providers, and your wifi router is less than four years old, you are probably ready for IPv6 addresses, although you may need to change your router setting. But if your Wi-Fi router is older than that, or you do not get your Internet service from one of the major US carriers, you may have more work to do to get ready before using any matter devices.

Google has a test page which will tell you if your network supports IPv6 or not. Make sure you visit the page from a device connected to the same Wi-Fi network that your matter devices will use.


The following is a good video explaining the issue.


4) If the device you want to add is individually certified for matter over thread, such as the Eve Energy smart plug, you also need to have a Thread border router. The SmartThings V3 hub, the Aeotec hub, and the SmartThings Station are all thread border routers. The V2 hub is not. But there are a number of other thread border routers available, such as the Apple HomePod mini, some Google home smart speaker models, some echo models, etc. so you may already have one.

The following is a very good explainer article about thread border routers:

What is a Thread Border Router? | Know-how | matter-smarthome

5) many devices are not individually certified for matter, but can be brought into matter through a matter bridge. This includes many zigbee devices, if their brand (or a third-party company) offers a “Matter bridge“ that can share those nonMatter devices with other matter commissioners. This is similar to how a hue bridge has always worked without matter to expose its connected devices to other home automation platforms.

For example, the aqara M2 hub is also a Matter bridge. So you can add some specific Aqara zigbee Sensors and switches that are not individually certified for matter to that hub, then add that hub to smartthings, and it will bring in some of its other devices with it. (But not necessarily all devices or all features.)

So in this device class, the matter bridge is certified for matter, but the individual end devices are not. This is also similar to how bridge devices work with Apple HomeKit.

At the time of this writing, smartthings/Aeotec hubs do not work as a matter bridge, so you cannot add them to other platforms. And there are as yet no plans to add that feature.

But there are a few matter Bridges from other brands that can now be added to your smartthings account using matter as long as you have the devices mentioned in one and two above. These include the SwitchBot hub 2 and some of the aqara hubs. Tuya and IKEA have announced that they intend to have some hub models which are also matter bridges, but those have not yet been released. Philips Hue released its matter bridge support for the hue hub in September 2023.

So, if you have the SwitchBot Hub 2, you could add it to your SmartThings account using matter, and it would bring in any curtainbots that you had connected to it. This would then give you a local connection to the curtainbots, which is not available through the pre-existing cloud to cloud integration. But again, you have to have both the matter controller from one above and the matter commissioner from two above set up.

So, as you can see, the answer to your question depends on the specific device you hope to add, and on the details of your smartthings set up.

On the smartthings side, you must have a SmartThings/Aeotec hub/dongle that can act as a Matter controller.

On the end device side, it depends whether that device uses matter over Wi-Fi, matter over thread, or a matter bridge.

If the end device is individually certified for matter over Wi-Fi, that’s all you need.

If the end Device is individually certified for Matter over thread, you also need at least one thread border router in your house.

If the end device is not individually certified for matter, but can connect to its own brand’s hub which can act as a “Matter Bridge“, then you can probably bring it into your SmartThings account that way.

You will not be able to add your smartthings/Aeotec hub to other matter platforms, because at the time of this writing, it only acts as a “matter controller,” it does not act as a “matter bridge.” :thinking:

if you have all of the requirements as listed above, but you are getting an error 39 – something when trying to add the device, make sure that both your hub and the device you are trying to add have the most current firmware.

For the smartthings/Aeotec hub, just unplug it, wait a few minutes, and plug it back in. That should cause it to re-sync with the smartthings cloud and get the newest firmware if it is available. For a V3/Aeotec hub, you need version 50 or above.

for the device you are trying to add, follow the manufacturer’s instructions to check the firmware level. For example, several community members reported different error 39 – somethings when they were trying to add a Tapo matter plug until they got the most recent firmware.
Matter is a rapidly developing standard with a lot of changes, and it can be possible for things to get out of sync.

Research note: Logos and product descriptions on AliExpress are frequently inaccurate. Sellers often just copy pictures or take parts of product descriptions from other places without really understanding them. So you cannot rely on a Matter logo on a product listing on that site. Logos on sites for authorized dealers should be fine, as well as on the manufacturer’s own site or their official Amazon storefront.
As of May 14, 2024, please do not ask questions about individual products displayed on AliExpress in this topic: it’s too much work for me to research those because the seller descriptions are so often inaccurate. Find the product description on the manufacturer’s own site or at an authorized reseller and you should be able to answer the question for yourself using the information in this post. If not, you can start a new topic requesting information about that specific seller listing, and hopefully other people will be able to help you.


And here’s the official Samsung support article on adding Matter devices, but it’s already a little out of date, and it was always incomplete. :man_shrugging:t2:


Recently the question has come up about what order you should add a matter device in if you want to use it with multiple platforms. The issue is that all of the different platforms are rolling out matter on a somewhat different timeline with different features first and it can get confusing.

Although different people have different preferences, at this point SmartThings and Apple Home are the most advanced in the number of matter features they support, including the number of different device classes.

After that comes Amazon Alexa, then Google Home. Followed by Tuya, Aqara, and IKEA, which at the time of this posting had each only implemented a couple of device classes.

So personally, if the device is individually certified for either matter over Wi-Fi or matter over thread, I add it via matter in the following order:

Apple Home
And then any of the others I want to use.

But a lot of people start with whatever app they use the most often, so if you use the SmartThings app, the most often, you might want to start with that one.

Note that all of the above only applies to the individually certified end devices, the ones that have a matter logo on the box.

If you are trying to add a device that will use matter over bridge like a SwitchBot Bluetooth curtainbot or an aqara Zigbee sensor or a Friends of Hue light switch you MUST use the manufacturer’s own app to add it there to whatever device will act as the “matter bridge.“ It varies from manufacturer to manufacturer, but you may also have to individually select that device for matter bridging in the device’s own app. Then you will add the matter bridge device to the other platforms, like SmartThings or Apple home.

If you have already added the matter bridge to other platforms via matter, no problem: again, you have to go into the Device’s own app and add the device to the matter bridge. It should then automatically get shared with the other platforms that have added that matter bridge. In some cases, you may have to reboot the bridge before new devices show up in the other platforms. (That just forces a matter sync.)

So… Theoretically, you are supposed to be able to start with any of the matter controller apps when you are adding a brand new individually certified matter device, but as of the date of this writing, in practice it seems to work a little better if you start from either Apple home or SmartThings. (Google home seems to be particularly bad at sharing matter devices with other platforms, although hopefully that will change in the future.)

If the device is not individually certified, however, but instead gets to matter via a “matter bridge“ then you have to use the app for the matter bridge first as that’s the only way that you can expose the device to matter.


Thank you very much for your response.

1 Like

11 posts were split to a new topic: Can I add this device to ST via Matter?

WiFi as a protocol doesn’t use repeaters The way the mesh protocols like Zigbee, Z wave, and thread do, so you can’t increase the max by adding a repeater.

The number of available Wi-Fi slots is determined by two things: the limit of your specific Wi-Fi router model, and any limit that your Internet service provider may apply.

If your router has a hard maximum of 28, 28 is all you get. You would have to change to a different model of Wi-Fi router to get more. It’s one of the reasons that Zigbee and Zwave became so popular for lighting: they don’t require Wi-Fi slots.

Matter doesn’t change anything with regard to the number of Wi-Fi devices you can connect.


Correct. Matter over WiFi has to make a regular Wi-Fi connection to your router. So if you have maxed out the number of allowed connections on your Wi-Fi router, you can’t add another Wi-Fi device, whether it uses matter or not.

To use the usual post office analogy, Wi-Fi is the system of trucks that deliver the letters and packages. Matter is a set of checklist forms that go inside the envelopes. Matter makes it easier for the recipient to know what the sender is asking for. But it doesn’t change how fast the truck can go or how many trucks you’re allowed to have.

1 Like

9 posts were split to a new topic: Questions about Matter over WiFi