Skip to main content
Developer DocumentationCertify and Publish Your DeviceSmartThings APIEnterprise API
Certify and Publish Your Device

Using the Certification Console

This reference guide provides step-by-step walkthroughs of common tasks in the SmartThings Certification Console, the web-based tool used to submit and manage Works with SmartThings certification requests. This document will help you:

  • Create an organization: Developer Center Organizations allow you to enable other users to help manage your brand and products in the Console.
  • Establish a brand: Create the public identity that appears to users in the SmartThings app.
  • Configure device onboarding behavior: Define how users pair and troubleshoot your devices.
  • Define your products: Input technical specifications and integration details for your specific hardware or cloud connections.
  • Submit for certification: Submit certification requests for your configured products.

Organizations​

Organizations allow you to enable other individuals to help manage your brand in SmartThings. 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.

Admins and Developers share the same privileges except for those specific to managing the Organization.

Only Admins can view members, invite members, remove members, edit member roles, edit the Organization name, and delete the Organization.

tip

To manage or join an organization, visit https://developer.smartthings.com/console/organization.

Brands​

A Brand creates the identity under which users see your devices in the SmartThings app. You must create a Brand before submitting a product for certification.

The brand name and logo you supply when defining your brand in the Console will be displayed to users in the SmartThings app.

tip

Manage your brands at https://developer.smartthings.com/console/brands.

Create a New Brand​

  1. Sign in to the Certification Console with your Samsung Account.
  2. If you have no existing Brands, start by adding a Product (see the Products section below), or click Create a brand here on the Create Product page.
  3. If you already have a Brand: Navigate to the Brands tab and click Add new Brand.
  4. Enter your Brand details:
    • Brand name: Enter the unique name for your brand.
    • Brand URL: Enter the main website URL for this brand.
    • Brand description: Write a short bio (max 500 characters).
    • Brand logo small (app version): Upload a JPG or PNG (min 240x240 px, 1:1 ratio).
    • Brand logo large (web version): Upload a PNG, JPG, or SVG (min 400x400 px, 1:1 ratio).
  5. Enter Customer support information:
    • Support email: Enter a valid support email address.
    • Support information: Provide troubleshooting tips and contact details.
  6. Enter Company details:
    • Fill in the Company name, Country/region, Address, City, State, and ZIP code.
  7. Enter Billing information (if different from the company address).
  8. Enter a Point of contact:
    • Provide the Contact name, Phone number, and Email address.
  9. Check the box next to "I am an employee or authorized representative of this Brand".
  10. Click Create a Brand.

Edit a Brand​

  1. Go to the Brands tab.
  2. Click the kebab menu (three dots) next to your Brand name.
  3. Select Edit Brand.
  4. Make your changes.
  5. Check the authorization box and click Update Brand.

Delete a Brand​

  1. Go to the Brands tab.
  2. Click the kebab menu (three dots) next to the Brand you wish to remove.
  3. Select Delete Brand.
    • Note: You can only delete Brands not currently used by a Product.
  4. In the pop-up window, click Remove Brand to confirm.

Onboarding Profiles​

An Onboarding Profile defines the pairing screens and troubleshooting instructions users see when adding your Hub Connected device.

Add a New Onboarding Profile​

  1. Sign in to the Certification Console.
  2. If you have no existing profiles, you must start by adding a Product. Select your integration type on the Create Product page, then click Create an onboarding profile here.
  3. If you have existing profiles: Navigate to the Onboarding Profiles tab and click Add new Onboarding Profile.
  4. Enter the Profile name: This describes the group of products using this profile (visible to users).
  5. Select the Product Type (Matter, Zigbee, or Z-Wave).
  6. Provide the following data in English (United States):
    • Profile name: The name users see in the app.
    • Pairing Instructions: Steps for adding the device in the SmartThings app.
    • Troubleshooting Instructions: Steps to resolve connection issues (can include external URLs).
    • Disconnection steps: (Z-Wave only) Instructions for resetting and removing the device.
  7. Add translations for other languages if applicable.
  8. Click Create profile.

Edit an Onboarding Profile​

  1. Go to the Onboarding Profiles tab.
  2. Click the kebab menu (three dots) next to the profile.
  3. Select Edit Profile.
  4. Make your changes and click Update Profile.

Delete an Onboarding Profile​

  1. Go to the Onboarding Profiles tab.
  2. Click the kebab menu (three dots) next to the profile.
  3. Select Delete Profile.
    • Note: You can only delete profiles not currently associated with a Product.
  4. In the pop-up window, click Remove Profile to confirm.

Products​

The Products section is your central hub for configuring devices and integrations before certification.

Add a New Product​

  1. Sign in to the Certification Console.
  2. Navigate to the Products section.
  3. Click the Add new product button (located on the main card or above your product list).
  4. Complete the Create Product form.

Part 1: Product Details​

These details appear to the end-user in the SmartThings app.

  1. Product name: Enter the name for the app listing.
  2. Model number: Enter the exact model number (must match the device shipped for testing).
  3. Brand: Select your Brand. If needed, click Create a brand here.
  4. Product category: Select up to 100 relevant categories.
  5. Product description: Describe the product.
  6. Product Image: Upload a transparent PNG (min 584x584 px).
  7. Product Purchase URL: Enter a link to buy the product.

Part 2: Integration Details​

Select your integration type: Edge Device or Cloud Device.

Option A: Edge Device (Matter, Zigbee, Z-Wave)

  1. Select Edge Device.
  2. Choose Standard (recommended) for standard functionality or Custom for custom drivers.
  3. Select your Protocol type (e.g., Matter, Zigbee, Z-Wave) and fill in the conditional fields:
    • Matter: Vendor ID (VID), Product ID (PID).
    • Zigbee: Manufacturer name, Model Identifier.
    • Z-Wave: Manufacturer ID, Product Type, Product ID.
  4. Driver: Select the driver for this product.
  5. Device Profile: Choose the profile that matches your configuration.
  6. Onboarding profile: Select an existing profile or click Create Onboarding Profile.
  7. Distribution: Check the boxes for the countries where the product will be available.
  8. Certification Testing Info: Provide hardware/firmware versions, power source, dimensions, and factory reset steps.
  9. Click Create Product.

Option B: Cloud Device (SmartThings Schema)

  1. Select Cloud Device.
  2. Schema App Details: Link the Schema App that connects your product to SmartThings.
  3. Schema App Display Name: Verify or edit the name users will see.
  4. Device Capabilities:
    • Select Manually enter your device info or select an onboarded device.
    • Enter the Device Handler Type Name or Device Profile ID.
  5. Distribution: Check the boxes for the countries where the product will be available.
  6. Certification Testing Info: Provide hardware/firmware versions, power source, dimensions, and factory reset steps.
  7. Review your details and save.

Certifications​

Once your product is created, configured, and tested, you are ready to submit for certification.

Submit a Certification Request​

  1. Sign in to the Certification Console.
  2. Go to the Certifications tab.
  3. If this is your first request: Select a Product and click Start a Certification Request.
  4. If you have previous requests: Click New Certification Request, select a Product, then click Start a Certification Request.
  5. Review Product Details: Click Continue to confirm or Edit Product to change.
  6. Review Brand Details: Click Continue to confirm or Edit Brand to change.
  7. Details for Testing: Provide specific handling warnings or instructions for the testers.
  8. Click Submit Request.

Certification Status​

Your request will show one of the following states:

  • Pending: Currently under review.
  • Approved: Successfully certified.
  • Rejected: Failed approval.
  • Cancelled: Request cancelled by user.

Cancel a Certification Request​

  1. Go to the Certifications tab.
  2. Click the Actions button next to your request.
  3. Select Cancel request.
  4. Click Confirm.