Latest Updates

March 22 2017

  • Composite Devices are here! Composite Devices allow developers to better model devices through a parent-child relationship between Device Handlers. Check out the documentation and leverage this new design pattern for your composite devices!
  • SmartThings has a new set of color standards for Device Handler Tiles. The Color standards documentation covers all the new color standards.
  • Updates to the Writing Style Guide and existing documentation to conform to new guidelines.

GitHub Release Tag


March 08 2017

  • Do you have custom LAN device integrations? If so, check out the Automatic LAN Device Discovery documentation to see what (if any) impact this has on your custom code.

GitHub Release Tag


March 02 2017

  • Does your SmartApp or Device Handler need to execute every minute? Instead of writing your own cron expression, use the new runEvery1Minute()!
  • Need to convert color values between hexadecimal and RGB? The ColorUtilities class has what you need.
  • If you are writing a parent-child SmartApp, check out the expanded and clarified documentation for using the app() input type.
  • A new capability, Bridge, allows devices to declare they act as a bridge to other devices.
  • A new attribute, held, has been added to the Button capability!
  • The Writing Style Guide has been updated with guidelines for document title and headings capitalization and formatting. If you are a contributor to these docs, make sure you check it out!

GitHub Release Tag


February 10 2017

  • Did you notice? We’ve updated the docs homepage to help readers quickly identify and navigate to common areas of interest.

GitHub Release Tag


February 08 2017

  • Z-Wave fingerprinting updates! The Z-Wave fingerprinting documentation has been expanded and updated with the latest information.
  • Get information about a Device’s status and last activity using the new getStatus() and getLastActivity() methods.
  • New to Device Handler development, or looking for a refresher? We’ve overhauled our Quick Start to ensure you can get up and running quickly and pain-free.
  • Do you use cron to create recurring schedules? Have you seen if you could replace that often-difficult to understand, write, and maintain cron expression with any of our runEvery* methods? We’ve updated the documentation to highlight these methods and encourage their use, instead of using cron.
  • Did you know you can copy code examples right to your clipboard? We updated the UX to increase the visibility of this handy feature.

GitHub Release Tag


January 23 2017

GitHub Release Tag


January 03 2017

  • Thinking about setting up a regular on and off schedule for your SmartThings? See our latest update, with examples, in Schedule using cron.
  • Confused about sharding and where to publish your SmartApp or Device Handler? Here is a big picture view that clarifies Publishing Custom Code.
  • Did you know there’s a default delay between commands when you send a sequence of them to the Hub? See sendHubCommand() reference documentation for details.

GitHub Release Tag


December 08 2016

  • Quick, how do you know what Capabilities are supported by SmartThings? Checkout out the new generated Capabilities Reference, now live.
  • Don’t know much about ZigBee? We got you covered with our updated ZigBee documentation in the ZigBee Primer and ZigBee Reference guides.
  • What you, as a developer, must know while working with the SmartThings IDE. Checkout latest in the Hubs and Locations guide.

GitHub Release Tag


November 30 2016

  • Did you know you can refresh any page of the SmartApp on the mobile device with a set interval? See the dynamicPage() options guide.

GitHub Release Tag


November 17 2016

  • Changed code blocks to use the monokai dark theme.

GitHub Release Tag


November 15 2016

  • Added ability to copy code blocks to the clipboard.

GitHub Release Tag


November 14 2016

GitHub Release Tag


November 10 2016

GitHub Release Tag


November 03 2016

GitHub Release Tag


October 26 2016

GitHub Release Tag


October 17 2016

GitHub Release Tag


October 13 2016

GitHub Release Tag

  • Moved rate limiting documentation into its own guide
  • Typo fixes and other copy edits

October 11 2016

GitHub Release Tag


October 06 2016

GitHub Release Tag


October 05 2016

GitHub Release Tag


September 23 2016

GitHub Release Tag

  • Added link to the Z-Wave public spec on the following Z-Wave pages: Building Z-Wave Device Handlers and Z-Wave Primer
  • Updated the Color Control capability to correctly reflect the capability definition.
  • Updated Jinja template to add some more features for the ongoing generated capability documentation project.
  • Fixed minor grammatical errors.

September 14 2016

GitHub Release Tag


September 09 2016

GitHub Release Tag

  • Removed Occupancy capability
  • Fixed unschedule() docs to clarify that a specific handler method name can be passed to unschedule().

September 02 2016 (3)

GitHub Release Tag

  • Fixing RTD build

September 02 2016 (2)

GitHub Release Tag

  • Fixing RTD build

September 02 2016

GitHub Release Tag

  • Typos and spelling fixes
  • Added more around the generated capabilities documentation framework
  • Added Troubleshooting document to the SmartApp Web Services guide
  • Fixed Color Control example code in the capabilities reference

August 17 2016

GitHub Release Tag

  • Fix documentation for subscribeToCommand() (only takes a Device argument, not a list of Devices)
  • Typos and spelling fixes

August 16 2016

GitHub Release Tag

  • Documentation for the ability to pass a Throwable to logging methods to get more logging details about the exception shown in the logs.

August 15 2016

GitHub Release Tag

  • Make edits to Makefile as a first step in getting generated capabilities documentation integrated into the documentation build.

August 04 2016

GitHub Release Tag

  • Added zigbee.parseZoneStatus() documentation
  • Added documentation for Additional ZigBee classes
  • Clarified findChildAppByName() API documentation
  • Added documentation to Device Handler Guide for other useful APIs available to Device Handlers, including Scheduling, HTTP Requests, and State.
  • Fixed documentation for Event.dateValue to indicate that it returns null if date cannot be parsed
  • Various fixes for reStructuredText formatting and legal syntax warnings
  • Moved this documentation change log to top of navigation

July 28 2016

GitHub Release Tag


July 25 2016

GitHub Release Tag

  • Add a strong warning to the State documentation to emphasize the importance of never mixing atomicState and state in the same SmartApp.

July 21 2016

GitHub Release Tag

  • Documented the new redirect URI field on OAuth SmartApps

July 07 2016

GitHub Release Tag

  • Added documentation for working with collections in State and Atomic State.
  • Added documentation for AppState
  • Added documentation for InstalledSmartApp
  • Added clarification that the callable URL for Web Services SmartApps will vary by installed location
  • Updated developer call schedule

June 23 2016

GitHub Release Tag

  • Splitting the Music Player capability into three capabilities
    • Audio Notification
    • Music Player
    • Tracking Music Player


June 13 2016

GitHub Release Tag


June 9 2016

GitHub Release Tag


May 27 2016

  • Add additionalParams argument for ZigBee library. Docs | GitHub PR

May 23 2016

  • Updated and expanded Device Handler tiles docs. Docs | GitHub PR.