Apply for Certification

Before Certifying Your Integration

• Self-Testing: Complete all QA and beta testing before submitting your product for WWST certification. Ensure that your device contains all required Capabilities for your device category and does not contain any custom Capabilities. You should not consider Certification as an opportunity for testing functionality of your product. If you fail Certification testing with the Authorized Test Provider, there may be associated costs for re-testing your integration.

• Approved Brand: Your integration must to be published under a valid brand name. You must be an authorized representative of the brand. Ensure your brand is approved prior starting a Certification request.

• Product Policies: Even if functional requirements are met, certification may be denied if it violates our Product Policies or compromises the value of SmartThings.

• Product Delivery: You must send two of each model of the device to the test provider before testing can proceed. If you plan to apply for certification for multiple devices with similar functionality (such as different colors or shapes), your products may qualify for Certification by Similarity. Please contact our team to avoid duplication of testing.

• Other Agreements: Besides the Samsung Account Privacy Policy and SmartThings Developer Terms of Service agreements you accepted to become a SmartThings Developer, there may be additional legal agreements required.

Submit a Pull Request

important

This step applies only to Hub Connected Devices that are seeking to create a new Device Profile or add a sub-driver. All other device integrations, including Hub Connected Devices built with the Edge Device Builder, skip to Submit a Certification Request.

Submit a pull request containing your Edge Driver changes against the SmartThingsEdgeDrivers public repository. You will be entering your pull request URL into the Certification Console in a later step. Your pull request will automatically be merged once your device is certified.

➡ Each device seeking certification must have its own pull request.

➡ Ensure your pull request code adheres to the Code Formatting and Submission Criteria outlined below.

➡ Thoroughly test your device behavior.

➡ Submit your pull request containing your changes against the SmartThingsEdgeDrivers public repository. By submitting a pull request, you represent that you have the right to license your contribution to SmartThings and agree that your contributions are licensed under the Apache 2.0 license.

➡ After submitting your pull request, you will be asked to agree to the SmartThings Individual Contributor License Agreement before your contributions can be merged. By submitting a pull request, you represent that you have the right to license your contribution to SmartThings and agree that your contributions are licensed under the Apache 2.0 license

➡ Once your device is certified, your pull request will automatically be merged and your Certified Device will be available publicly in the SmartThings app.

You will also be asked to associate your product with a driver and fingerprint in the Console. The driver package is uploaded and associated with your organization ID during the development process using the SmartThings CLI.

If your driver and fingerprint do not appear in the Console dropdown menu when creating your product in the Console, you can use the following command in the SmartThings CLI to upload your driver and associate it with your organization ID:

smartthings edge:drivers:package [path_to_dir] -O [organization_id]

Submit a Certification Request

Hub Connected Devices (Matter | Zigbee | Z-Wave)

After testing your product and submitting an Edge Driver pull request (if applicable), add your product info in the Certification Console and submit a new certification request:

tip

If using the Edge Device Builder, you will be directed to the Certification Console after selecting your device, with several fields auto-populated based on your device selection.

1. Visit the Certification Console and click Products.
2. Enter your Product Details and click save.
3. Click Certifications in the left-side panel.
4. Start a new certification request by selecting your product from the drop-down list.
5. Fill out the Request Details and submit your certification request.

Cloud Connected, Direct Connected, and Mobile Connected Devices

After developing, testing, and registering your product in the Developer Workspace, fill out the certification application form. The completed application form must be submitted when requesting certification in the Developer Workspace as follows:

1. Click your project in the Developer Workspace.
2. Click Publish - Publish Request in the left panel.
3. Click START A REQUEST.
4. Select "Works With SmartThings (WWST)" Certified Device.
5. Fill out the Request Details and submit it with your certification application.

If "Certified Device" is not enabled or there is no such menu, contact our team to apply for certification.

Submission Review

Our certification team will review the submitted application according to our Product Policies within 3 working days. When your application is approved, you and the Authorized Testing Partner will be notified. If there is an error in the application, we will guide you on how to correct it.

Testing Quote

The Authorized Test Provider will issue a price quote for certifying your device. See the pricing guide for estimated test costs. Once you accept the quote, the Test Provider will provide guidance on shipping your product. If you deny the quote or do not respond to the quote within 90 days from when you originally submitted your certification request, your certification request will be cancelled at the discretion of SmartThings.

The test plan and test scope are determined by the following:

• The type of device and the functionality that you use to connect with SmartThings
• The Capabilities that your product supports
• The technical specifications of your product
• The compatibility of countries in which you want the product published
• Any additional work according to the characteristics of your products

note

Multiple devices sharing features may save time and cost with the Certification by Similarity program.

Ship Your Device

After accepting your certification quote, the Authorized Test Provider will provide guidance on shipping your product. Depending on the size or type of product, you may need to ship either the entire product or a working, representative component. At least two identical devices must be shipped to confirm the normal operation of the product. Functional tests are provided in the United States and South Korea. You can choose either region. If possible, we recommend a location close to the market where the product will be released.

info

Direct Connected Devices that require supplemental testing may be sent to partner laboratories in Germany or China for security review.

Device Testing

The Authorized Test Provider will validate that your product complies with the Works with SmartThings performance requirements. After the test provider finishes testing, they will provide you with a copy of the results and will send the results to the WWST team for review. This process takes about 10 working days.

If your product does not pass the test plan, you will be provided with re-test instructions. After correcting any issues, you can request a re-test. A re-test will check only the failed items.

tip

Before submitting your device for certification, you can obtain a list of all test cases associated with a particular Capability by submitting a support ticket.

Testing Guidelines

All integrations will be thoroughly tested as part of the WWST certification process. Specific testing will be determined based on the type of product you submit for certification. For example, testing for motion sensors will be different from light bulbs.

Devices	Hub Connected	Pairing and Onboarding Control via Capabilities Verification Device Reset UI/UX Content
	Cloud Connected	Onboarding Control via Capabilities Cloud Connectivity Rate Limit Compliance
	Direct Connected	Pairing Control via Capabilities Security Review
	Mobile Connected	Pairing Connectivity (including reconnection by proximity BLE) Control via Capabilities UI/UX Content
Connected Services	OAuth	Authorization Content Privacy Policies Rate Limit Compliance

Publish Your Device

Hub Connected Devices (Matter | Zigbee | Z-Wave)

Hub Connected Devices will automatically be published to the SmartThings catalog once certified.

Cloud Connected, Direct Connected, and Mobile Connected Devices

If your device passes testing, you can publish your product from the Developer Workspace. You can select a date to publish your device that is at least 3 days after the date your device passed certification.

When certification is complete, the Works with SmartThings logo can be used for your product and package. The logo and guidelines can be downloaded as part of our press kit. SmartThings compatible (legacy program) and non-certified products are restricted from using the logo. If you want to use the logo, please follow the Works with SmartThings certification procedure above.

Certified products can be displayed in the SmartThings app and website, helping customers find the products they need. In order to expedite the process, we have created this form to collect the following product information:

• Lifestyle Images
• Product Descriptions
• Product Images
• Brand Images
• Buy Now Links

Additionally, customers must be able to contact you with support questions. Ensure your integration, support URLs, and contact information are included.

Additional information

Tracking Your Certification

After you submit your product for certification, you can view your certification request on the Certification page. You can track the status of your certification request in the status column. See below for an explanation of status codes:

• SUBMISSION RECEIVED: The certification application has been received. The test provider will issue a quote. If there are any errors in the application form, we will guide you on how to correct them.
• WAITING FOR DEVICE: The test provider is waiting for the devices.
• TESTING: The device has been delivered and testing is in progress.
• PASSED: The product has passed the certification test. It has not yet been released to users, and the WWST logo may be used on products.
• FAILED: You did not accept a quote for the re-test.
• PUBLISHED: The product has been registered in the SmartThings catalog. The certification process is complete.
• CANCELLED: The certification request has been cancelled.

Brand and Organization Management

The brand name and logo you supply when defining your brand in the Workspace or Console will be displayed to users in the SmartThings app. If you use others' trademarks or use inappropriate images, your request may be rejected.

Organizations allow you to enable other individuals to help manage your brand on SmartThings.

Brand and Organization Management in the Console

To manage your brand, visit https://developer.smartthings.com/console/brands.

Joining or creating an organization is optional when using the Console. Members of the same organization will have access to all brands associated with the organization. To manage or join an organization in the Console, visit https://developer.smartthings.com/console/organization.

Brand and Organization Management in the Workspace

note

Brands and organizations created in the Console do not sync with the Developer Workspace.

To create or join an existing organization in Developer Workspace, email partners@smartthings.com with the following information:

• For new organizations:
  • Organization name.
  • The Samsung account(s) to add to the new organization.
  • The role (admin or developer) you wish to assign to each Samsung account to be added to the new organization.
• For existing organizations:
  • The name of the organization you wish to add a new user to, or remove a user from.
  • The email address of the samsung account you wish to add or remove from the organization.
  • The role (admin or developer) you wish to assign to the new user.

To create a brand in Developer Workspace:

1. Create or join an organization that exists in the Developer Workspace.

2. Change the workspace to your company at the top-right in the Developer Workspace.

3. You can manage brand information. For more information, visit the Developer Workspace.

Stale Certification Requests

Certification requests awaiting a response from you may be closed after 90 days from the original submission date at the discretion of SmartThings.

Rejection

If we reject your submission, review the Testing Guidelines. Once you have verified your changes, you can re-submit your device for WWST certification. Note: fees may be incurred by the Certification vendor for multiple rounds of testing. For getting additional troubleshooting support is needed to complete certification, visit the SmartThings Developer Documentation or Community forums. If you believe we have erred in our rejection, you may file an appeal using this form. Filing an appeal is not a guarantee of success, but we will give your appeal fair consideration.

Release Management

You cannot change your integration after certification is complete. In order to upgrade your integration or change the content, you will need to version your WWST certification submission using the Developer Workspace. For more information, visit the Publish section of the Developer Workspace.