Skip to main content

Works With SmartThings Certification

caution

Guidelines for Works with SmartThings Certification are currently under development and subject to change.

Overview#

The SmartThings Platform is an ecosystem that includes over a billion Galaxy devices and Samsung appliances, millions of customers, and an ever increasing number of partners and developers. SmartThings technology is powering smart homes around the world.

We believe that a large ecosystem of partners is the best way to bring joyful and meaningful moments to customers. Our Works with SmartThings (WWST) program makes it easy for you to help make these moments. If you want to join the WWST ecosystem, we expect that you will provide a high quality experience that customers can trust.

This guide provides a detailed summary of the security, data privacy, performance requirements, compatibility, branding assets and legal agreements necessary to bring your experiences to the WWST program.

Benefits of WWST#

Once you finish building your integration, you can start the Works with SmartThings Certification process. If you do not believe that your integration will meet the standards required for certification, we encourage you to participate in our Community. We have made our tools available to the public so that you can build these experiences and distribute outside of the WWST ecosystem.

Here are some of the many benefits to joining the Work with SmartThings program:

Works With SmartThingsCommunity Integration
Marketing
Listed in SmartThings App
Product display on SmartThings.com
Brand association with Samsung SmartThings
Use of WWST logo
Bundling opportunities with Samsung Products*
Marketing Support*
Feature in SmartThings Mall section of the SmartThings mobile app*
Participation in Samsung and SmartThings announcements*
Technical
Controlled by Automations
Post-Certification SupportEmail Support Team
Access to Early Access programs
Business
Participate in an open ecosystem
Data reports of integration use*
Dedicated Business Development support*

*at the discretion of SmartThings

What you Should Know#

Smart homes are meant to be an ecosystem. We know that SmartThings can only succeed with partnerships. We want to work with you to add more devices and integrations to customers’ homes.

We also know that you have a business to run. The following guidelines will help you understand how we want to collaborate with you on building experiences for customers.

Your Rights#

You own any integration that you create. This means that you are responsible for ensuring everything in your integration complies with SmartThings Terms of Service and local legal requirements in regions where you distribute. We must comply with local laws in all markets that we operate, and expect you to do the same.

Intellectual Property#

Do not use protected third-party material such as trademarks without permission. Integrations should be submitted by the person or legal entity that owns or has licensed the intellectual property and other relevant rights. If you believe your intellectual property has been infringed upon by another developer, let us know here.

As part of the Works with SmartThings certification process, we will test your integration in a laboratory environment. Please provide an active demonstration account and login information, plus any devices or hardware or resources that may be included in certification. We will not attempt to use your integration outside of the testing requirements defined in the Developer Workspace.

If you have a great product that has not been released yet, feel free to start the certification process. If we like your product, we may even ask to help you launch it.

Proof of Business#

In order to submit a product for WWST certification, you must verify your business identity. You can do this by Enrolling as an Organization in the SmartThings Developer Workspace. Once registered, you will receive an email with your Manufacturer ID (MNID). Store this for future reference.

Right to Remove#

Typically, we will provide you with a notification if there is an issue with your integration. However, we reserve the right to remove your integration from the SmartThings Catalog or terminate access to the SmartThings Cloud without notice. Repeated or serious violations of the guidelines may result in further termination of individual, partner, or other related accounts.

Performance and Stability#

A great user experience is paramount when it comes to integrating your product with SmartThings. We consistently strive to bring customers the most seamless, low latency smart home experiences. Ensuring your systems are always running and up to date is important - especially if a user is controlling/connecting to your service via a cloud infrastructure.

Best Practices#

Consider how a user will interact with your product, including setup and control. Use the resources available in our Documentation and code samples to assist with the development and testing of your integration. Use the SmartThings Community to discuss your ideas and best practices for staying below the platform rate limits.

Brand and Marketing Guidelines#

The WWST logo provides customer awareness and trust that your product has been certified by SmartThings. After your integration has passed WWST certification, you will be able to use the WWST Brand logo. If your product has not completed certification, you cannot use the logo. More information is available in WWST Brand and Trademarks



Security#

Smart homes are meant to be peaceful sanctuaries. Many smart homes have families of diverse ages and backgrounds. The following guidelines ensure that all customers will feel comfortable with their smart home and content in the SmartThings apps.

In addition to the below guidelines, we may use our discretion to determine if your integration violates local laws or customs.

Sexual content#

Your integration must not:

  • Present or encourage overt sexual concepts or content (including, but not limited to, explicit nudity, exposed male or female genitalia, pornography, pedophilia, bestiality, sexually explicit behavior, and sexually suggestive poses).
  • Present or encourage exploitative sexual behavior (including, but not limited to, sexual abuse, sexual assault, and bestiality).

Violence#

Your integration must not:

  • Present or encourage murder, suicide, torture, or abuse.
  • Present or encourage violence or criminal behavior that could instigate a crime.
  • Present or encourage violent threats toward people or animals.
  • Present or encourage recklessly gruesome content (including, but not limited to, excessive bleeding).
  • Present or encourage use in the real world of weapons, bombs, terrorist actions, or other dangerous objects.
  • Contain content that could lead to self-harm, choking, serious injury, or death.

Alcohol, tobacco, and drugs#

Your integration must not:

  • Present or encourage the illegal use of alcohol, tobacco (including electronic cigarettes), or drugs.
  • Present or encourage the sale of alcohol, tobacco (including electronic cigarettes), or drugs to minors.
  • Encourage excessive consumption of or make unnecessary references to alcohol, tobacco, or drugs.
  • Encourage consumption of recreational drugs.
  • Present medical information to users, and must notify users that the medical information could be inaccurate.
  • Contain unauthorized drugs, regulated drugs, dietary supplements, or products with names or designs that can cause user confusion.

We understand that some substances may be considered regulated or recreational in some regions but not others. If there is any nuance, we will err on the side of not accepting your product for WWST Certification.

Defamation and vulgarity#

Your integration must not:

  • Present content that could defame (by slander or libel) individual persons or groups of people based on race, gender, sexual preference or identity, ethnicity, nationality, disability, religion, political identity, or ideology.
  • Present excessively unpleasant, repellent, obscene, or vulgar language or expressions.
  • Present offensive, discriminatory, or inflammatory content about specific religious, social, or political parties, groups, or concepts.
  • Present content that reasonable public consensus may find to be improper or inappropriate

Child safety#

We have a zero-tolerance policy against any form of child or sexual abuse content, including but not limited to any sexual exploitation of minors.

If we become aware or are informed of any integration or content promoting or facilitating the distribution of any form of child sexual abuse content, we will promptly report it to all appropriate authorities and remove the SmartThings Developer, User Accounts, and anyone else that may be involved with the distribution.

Illegal activities#

We do not permit integrations that promote illegal activities. You are responsible for determining the legality of your integration in countries where it will be available to SmartThings customers. If we determine that your integration is unlawful in specific countries where you have made them available, we will remove it.

Data Privacy#

Smart homes are meant to be private. The following guidelines ensure that all customers will feel protected and secure with their smart home and content shared with SmartThings.

We follow all local laws and guidelines for the distribution of any third party integration to consumers. In addition to the requirements below, you must comply with the local data privacy laws of the country or region where you make your integration available. Be sure to check each country’s local laws.

Privacy#

Your integration must:

  • Provide a mechanism for users to delete their data. Customers are trusting us with their data. They must be able to delete this data from your systems.
  • Display a user privacy policy during registration if personal data is transmitted outside of the SmartThings cloud.
  • Not access, collect, use, transmit, or share user data without explicit user consent in accordance with local laws.
  • Not require that the user grant more permissions or provide more personal information than the minimum necessary to successfully support features.

Additionally, your privacy policy must include the following information:

  • Collected user data items and types
  • Purposes of using user data
  • List of third-parties with which the app shares user data and shared data types
  • User data items and data types that the app shares with third-parties
  • User data retention period and user data deletion (for example, upon account deletion or integration uninstallation)
  • Method of notifying users when the privacy policy is revised
  • User data-related privileges (such as reading, revising, or deleting data) that can be requested by users

Experience#

Smart homes are meant to be natural. People want to have unique experiences that can adapt to their physical surroundings, local designs, and enhance every difference that makes each person special. Whether it’s having the thermostat lower the temperature when the user leaves their home or having the lights change intensity and color based on an event the user defines. Almost anything is possible.

We want people to feel that way when they integrate your product with SmartThings. Users should trust that their integration is providing an original experience, using trusted standards, and accessible to everyone in the home. The following section details the expectations for you when building these distinct solutions.

Original Design (Intellectual Property Protection)#

Do not copy another product experience. Add a bit of flair to make your integration unique to your organization. Do not make small changes to someone else’s integration and attempt to submit it as your own.

Device or Service Ownership#

Some product owners may not want all of their features available on SmartThings. We know that many developers like to make their own versions of an integration. These alternative integrations are not permitted for WWST certification.

You must be the owner, or an authorized representative, of an organization that owns any IP rights to your product or service.

  • If you are submitting a Device for certification, you must be the OEM or authorized representative (e.g., authorized contract manufacturer).
  • If you are submitting a Connected Service for certification, you must be an authorized representative of the service.
  • In certain cases where you are seeking to certify an open source product or platform that may not have an IP owner, you must be a recognized contributor to the project.

If we determine that you have submitted a product Certification or are representing a company without their authorization, your SmartThings Developer account will be deleted and you will lose access to any information you have submitted to SmartThings.

We reserve the right to delist your product from the Catalog at any time. Refer to Section 5. Submission, Certification, and Distribution of Applications of the SmartThings Terms of Service for additional details.

Modern Standards#

When designing how consumers will use your device, consider how to apply best practices for reliability & uptime, UI interaction and design, optimizing code to improve performance, and other aspects. What are the best apps you use today on your smart phone or in your home? Why do these apps and experiences resonate well with you? Think about how to apply a similar experience with your device integration or connected service.

WCAG Compatibility#

Having a great consumer experience for everyone is paramount when designing your integration. Consider using best practices found in the Web Compatibility and Assistance Guidelines. Examples include providing different text sizes for readability, using alternative text for images, and supporting dark mode. Refer to the WCAG for additional information.

Language Localization#

The minimum requirement is for your integration to be in English or Korean. To offer the best user experience, SmartThings supports 30+ languages. We encourage you to localize for countries where customers may use your device. In non-English speaking countries, the SmartThings app will select the closest available language (default English).

Certification#

caution

Devices with [custom Capabilities](/docs/devices/capabilities/custom-capabilities] are not supported by the Works with SmartThings certification program at this time.

Smart homes are meant to be reliable. We know that you invested sweat (and maybe a few tears) - into building these one-of-a-kind experiences - and want customers to know that this energy was worth every sleepless night. The Works with SmartThings brand is our recognition of all the hard work you put into making this integration possible.

Here is some high level guidance on what we will be testing during certification - the detailed requirements will be provided as part of your Certification Agreement.

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, which will be different from Connected Services.

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
  • Content and Images#

    We want to help millions of smart home users discover your products and services. Once certified, we will include information about your products in the SmartThings app and website. In order expedite the process, we ask that you provide the following items:

    • 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. Excessive customer support requests to Samsung SmartThings for your product could result in removal of certification.

    Beta Testing#

    You should not consider WWST Certification as an opportunity for testing functionality of your product. Complete all QA and beta testing before submitting your product for WWST certification.

    Product Delivery#

    If you are submitting a Device for certification, you must send two of each model of the device to the SmartThings Certification Center before testing can proceed. Best judgement is required. Example: If two items have different model numbers due to different colors or aesthetics, but maintain the same functionality there is no need to send extra devices (totaling four); two of the same device of one of the models is sufficient.

    If you are submitting a Connected Service for certification, you must ensure that a demonstration account is available for use at the Certification Center. This includes access to any content that might typically require a subscription. The demonstration account must include working devices that are in the online state for remote access and available for control.

    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.

    Next Steps#

    We know that by this point you are excited to start distributing your integration. However, we ask you to be patient while we provide thorough testing. Below are some expectations of next steps.

    Review Process#

    We use third party vendors to perform Certification testing. There is a nominal cost to complete testing - you can find a pricing table for single products here.

    tip

    Bulk pricing may be available if similar products are submitted for Certification. Please consult the third party vendor if your products are eligible for discounts.

    The typical certification review takes around 2-4 weeks to complete. If we have questions, we may reach out via email or directly through the Developer Workspace.

    You can track status updates in the SmartThings Developer Workspace. If we have questions, we will reach out to you directly.

    Rejection#

    If we reject your submission, review the Certification 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.

    If 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](https://support.smartthings.com/hc/en-us/requests/new?ticket_form_id=1900000091487). Filing an appeal is not a guarantee of success, but we will give your appeal fair consideration.

    Approval#

    Yes! Now your product is certified to Work with SmartThings! We will send you a Certificate of WWST Certification and a link to download the WWST Brand Toolkit. You are welcome to use these on your website, packaging, etc. in compliance with our Licensing and Marketing guidelines.

    You can choose the date to publish your integration in the SmartThings Catalog using the Developer Workspace. For more information on publishing your integration, visit the Developer Workspace.

    Remember, once your integration is live, it will be available for millions of users to install. If you maintain a cloud service, ensure your infrastructure is prepared for potential growth.

    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 your Developer Workspace.