Skip to main content

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

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.

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 will automatically be published to the SmartThings catalog once certified.

    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 Management in Developer Workspace

    Here's how to create and manage your brand. The applied brand name and logo will be displayed to users in the SmartThings app. If you use others' trademarks or use inappropriate images, your request may be rejected.

    1. Register your company information or join an organization that has already been created.
    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.