{"_id":"59e59399d9a506002eaab3f8","project":"568bdc1483d2061900d86cdc","version":{"_id":"59a72290d61777001b6c42c3","project":"568bdc1483d2061900d86cdc","__v":33,"createdAt":"2017-08-30T20:39:44.453Z","releaseDate":"2017-08-30T20:39:44.453Z","categories":["59a7236e3fe4d90025117c10","59a72eb6cb0db3001b84cfe2","59a734eb757d030019b85af8","59c0243b1b2d07001a9d2b76","59c035e42126e10028effb12","59c06c40df5b3c0010584a13","59c1a5852cabe5002641a3e7","59c2fb00b2b45c0010b7a3d7","59c32ceb9aea850010ac4130","59c32e6e190c90003cb0d12f","59c33affb2b45c0010b7aa23","59c7dfa457bd8200105444dc","59c7e975c50cf30010d712a0","59cffdef0cd4dd0010294d54","59d0622ca91a810032c8f60c","59d06733c1aec60026253065","59d174d44ac471001a07b123","59d5a5e323e6e800103defb2","59ecf1d8ed507c001c52b255","59f76fef8581dc0010593e6f","5a0c003680a35b0012c35db0","5a8358722e78660075e45f42","5a846645b5ec3a001203517e","5b258091bc7a6700033b9cb5","5b26e48e024807000315a740","5b44edff3306680003663f5c","5b468abd3d4a9e0003789111","5b468d8f3dcb6a0003c6e374","5b47b0b93d4a9e000378a33a","5b538d114ea24f00033c726f","5b6a0efe402b32000336c33f","5bba5e5d7ba7710003bd902a","5bc2703349ac3a0013eec3e5"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"0.0.0","version":"0"},"category":{"_id":"59cffdef0cd4dd0010294d54","project":"568bdc1483d2061900d86cdc","version":"59a72290d61777001b6c42c3","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2017-09-30T20:26:23.487Z","from_sync":false,"order":2,"slug":"platform-overview","title":"Platform Overview"},"user":"568bdbc4fe6fcc0d006dc970","githubsync":"","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-10-17T05:22:33.562Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":7,"body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Overview\"\n}\n[/block]\nA **zone** in droplit.io is an organizational structure inside of environments.\n\nZones may group devices by physical use or location. For example, the zone “ConferenceRoom” may represent a room and all its devices, while another zone inside of “ConferenceRoom”, such as “Lighting”, may encompass all the lights in that room.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Zone Items\"\n}\n[/block]\nA zone can contain references to:\n* [Devices](doc:devices) \n* Other [Zones](doc:zones)\n[block:api-header]\n{\n  \"title\": \"Commands\"\n}\n[/block]\nZones may be issued commands that will then be executed by all applicable devices contained within it. If a zone's [service property](https://docs.droplit.io/v0/docs/services#section-properties) is updated, the service properties of all devices that share that service property will be similarly updated.\n[block:api-header]\n{\n  \"title\": \"Metadata\"\n}\n[/block]\nZones can store custom [metadata](doc:metadata) in their records. Metadata is any superfluous data that enhances the operation of the zone. Icons, sorting metrics, and qualitative identification information are all examples of metadata.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Aliasing\"\n}\n[/block]\nIn order to ease referencing, zones can be [aliased](doc:aliases).","excerpt":"An array of devices and zones","slug":"zones","type":"basic","title":"Zones"}

Zones

An array of devices and zones

[block:api-header] { "type": "basic", "title": "Overview" } [/block] A **zone** in droplit.io is an organizational structure inside of environments. Zones may group devices by physical use or location. For example, the zone “ConferenceRoom” may represent a room and all its devices, while another zone inside of “ConferenceRoom”, such as “Lighting”, may encompass all the lights in that room. [block:api-header] { "type": "basic", "title": "Zone Items" } [/block] A zone can contain references to: * [Devices](doc:devices) * Other [Zones](doc:zones) [block:api-header] { "title": "Commands" } [/block] Zones may be issued commands that will then be executed by all applicable devices contained within it. If a zone's [service property](https://docs.droplit.io/v0/docs/services#section-properties) is updated, the service properties of all devices that share that service property will be similarly updated. [block:api-header] { "title": "Metadata" } [/block] Zones can store custom [metadata](doc:metadata) in their records. Metadata is any superfluous data that enhances the operation of the zone. Icons, sorting metrics, and qualitative identification information are all examples of metadata. [block:api-header] { "type": "basic", "title": "Aliasing" } [/block] In order to ease referencing, zones can be [aliased](doc:aliases).