Skip to content

JSON Basics

Arie J. Godschalk edited this page Nov 15, 2026 · 1 revision

JSON basics

Home › JSON basics

JSON is a way to write down values as text. It is often used to exchange information between apps and services. A property is a named value; an object is a collection of named properties inside braces.

{
  "room": "Kitchen",
  "temperature": 21.5,
  "online": true,
  "readings": [18, 19, 21],
  "note": null
}

Here room is text, temperature is a number, online is a yes/no value, readings is an array (an ordered list), and null means no value. Arrays use square brackets. The first array item has index 0, not 1. Objects and arrays can contain other objects and arrays.

Use straight double quotes around property names and text. Numbers and true, false and null are not quoted. Separate entries with commas, but do not add a trailing comma. A quoted number like "21" is text, not the number 21. Curly “smart quotes”, comments and JavaScript's undefined are not valid JSON.

JSON Handler passes JSON as a text token, not an automatically saved file. Choose a matching text, number or yes/no output when reading a value; a type mismatch can make Homey reject the token.

Next: build and read a small example or read nested values.

Clone this wiki locally