Matter 1.6.1 Cluster Descriptions
Every standard Matter 1.6.1 application cluster with its decimal and hex ID, cluster revision, and a plain-English description, for reading device-shadow paths.
Matter 1.6.1 Clusters — Decimal IDs and Descriptions
This page lists every standard cluster in the Matter 1.6.1 Application Cluster Specification using the decimal cluster ID format used in SmartphoneKey backend paths and device shadows.
Source: the CSA 1.6.1 data model as published in project-chip/connectedhomeip (data_model/1.6.1/clusters). Matter 1.6.1 is a maintenance release of 1.6; it adds no new device types.
Reading a shadow path
For a Matter shadow path like:
1/257/0
read it as:
endpoint_id / cluster_id_decimal / attribute_id_decimal
So 1/257/0 means Endpoint 1 / Door Lock cluster (257) / attribute 0 (LockState).
Cluster IDs below 0x8000 (decimal 32768) are standard CSA clusters. IDs of the form 0xVVVVFCxx (decimal above 4 billion, for example 308084743) are vendor-specific clusters and are not covered here.
Changes since Matter 1.5
| Change | Clusters |
|---|---|
| New clusters | 100 Temperature Alarm, 101 Groupcast, 1073 Ambient Context Sensing |
| Revision bumps | 8 Level Control (6→7), 31 Access Control (2→3), 40 Basic Information (5→6), 51 General Diagnostics (2→3), 57 Bridged Device Basic Information (5→6), 63 Group Key Management (2→4), 69 Boolean State (1→3), 92 Smoke CO Alarm (1→2), 128 Boolean State Configuration (1→2), 257 Door Lock (9→10), 258 Window Covering (7→8), 512 Pump (4→5), 513 Thermostat (9→11), 514 Fan Control (5→6), 768 Color Control (8→9), 1024/1026/1027/1028 measurement clusters (+2 each), 1030 Occupancy Sensing (5→7), 1361 Camera AV Stream Management (1→2), 1363/1364 WebRTC (1→2), 1365 Push AV Stream Transport (1→2), 1366 Chime (1→2) |
| Removed clusters | none |
| Thread / Wi-Fi diagnostics | unchanged: 53 Thread Network Diagnostics stays revision 3, 54 Wi-Fi Network Diagnostics stays revision 1 |
The previous version of this page (Matter 1.5) contained incorrect decimal IDs for several clusters (energy, media, camera, metering, closure and concentration clusters, among others). All IDs below are taken directly from the specification data model. If you built logic on the old table, re-check the IDs you use.
How the table is organised
- Decimal: the cluster ID as it appears in shadow paths. Hex IDs and cluster revisions are on each cluster's own page.
- Cluster: links to the detailed page for that cluster (attributes, commands, events, data types, bridge payload examples).
- New marks clusters that did not exist in Matter 1.5.
General and node management
| Decimal | Cluster | Description |
|---|---|---|
| 3 | Identify | Lets a device or endpoint identify itself visually or audibly (blink, beep) for pairing, setup, or troubleshooting. |
| 4 | Groups | Manages group membership so one multicast command can control multiple endpoints together. |
| 29 | Descriptor | Describes an endpoint: device types, server/client clusters, parts list, and endpoint composition (tag list). |
| 30 | Binding | Local bindings between endpoints so one device can send commands directly to another without a controller. |
| 31 | Access Control | Access Control List: which fabrics, nodes, CATs, or groups hold which privileges. Revision 3 adds auxiliary ACL support. |
| 37 | Actions | Predefined actions and action lists (scenes-like automations) that can be triggered on a device. |
| 40 | Basic Information | Core node information: vendor, product, serial number, software version, node label, location, capability minima. |
| 41 | OTA Software Update Provider | Serves OTA software update images to other Matter nodes. |
| 42 | OTA Software Update Requestor | Lets a node query for, download, and apply OTA software updates. |
| 43 | Localization Configuration | Active locale and supported locales for user-facing text. |
| 44 | Time Format Localization | Localized time display preferences such as 12-hour or 24-hour format and calendar type. |
| 45 | Unit Localization | Preferred temperature unit (Celsius / Fahrenheit / Kelvin). |
| 46 | Power Source Configuration | Lists the Power Source endpoints that feed this endpoint, in priority order. |
| 47 | Power Source | Status of one power source: battery level, charge state, voltage, wired supply, faults, replacement info. |
| 48 | General Commissioning | General commissioning steps: arm fail-safe, regulatory configuration, commissioning complete, terms and conditions. |
| 60 | Administrator Commissioning | Opens or revokes commissioning windows so additional administrators/fabrics can be added. |
| 62 | Operational Credentials | Operational credentials: fabrics, NOCs, trusted root certificates, fabric add/update/remove. |
| 63 | Group Key Management | Group keys and key sets used for secured multicast (group) communication. |
| 64 | Fixed Label | Manufacturer-defined static labels for an endpoint. |
| 65 | User Label | User-editable labels for an endpoint. |
| 98 | Scenes Management | Stores, recalls, copies, and manages scenes across clusters (replaces the legacy Scenes cluster). |
| 101 | Groupcast (New) | Groupcast: group messaging configuration that consolidates Groups + Group Key Management use cases. New in 1.6. |
Networking and diagnostics
| Decimal | Cluster | Description |
|---|---|---|
| 49 | Network Commissioning | Adds, removes, scans, orders, and connects Wi-Fi, Thread, or Ethernet networks on the node. |
| 50 | Diagnostic Logs | Retrieves device diagnostic logs (end-user, network, crash) for support and troubleshooting. |
| 51 | General Diagnostics | General diagnostics: network interfaces, reboot count, uptime, boot reason, hardware/radio/network faults, test event triggers. |
| 52 | Software Diagnostics | Software diagnostics such as thread/task metrics, heap usage, and software faults. |
| 53 | Thread Network Diagnostics | Thread radio diagnostics: role, channel, PAN, neighbor and route tables, MLE/MAC counters, dataset components. See the Cluster 53 page. |
| 54 | Wi-Fi Network Diagnostics | Wi-Fi radio diagnostics: BSSID, security type, PHY version, channel, RSSI, beacon and packet counters. See the Cluster 54 page. |
| 55 | Ethernet Network Diagnostics | Ethernet diagnostics: PHY rate, duplex, packet/collision/error counters, carrier detect, time since reset. |
| 56 | Time Synchronization | Time synchronization: UTC time, granularity, trusted time source, time zone, DST offsets, NTP settings. |
| 70 | ICD Management | Intermittently Connected Device management: idle/active mode durations, registered clients, check-in protocol, LIT/SIT. |
| 1105 | Wi-Fi Network Management | Wi-Fi network management on a Wi-Fi router/hub: SSID and passphrase provisioning for home-router devices. |
| 1106 | Thread Border Router Management | Thread Border Router management: active/pending dataset, border router name, Thread interface state. |
| 1107 | Thread Network Directory | Thread network directory: list of Thread networks known to a hub, with their PAN IDs and names. |
Bridges and fabric administration
| Decimal | Cluster | Description |
|---|---|---|
| 57 | Bridged Device Basic Information | Basic information for a non-Matter device represented behind a Matter bridge (vendor, product, reachable, serial, unique ID). |
| 1872 | Ecosystem Information | Ecosystem information: device directory and location descriptors shared across ecosystems for bridged devices. |
| 1873 | Commissioner Control | Commissioner control: lets a device ask a commissioner to commission another device (reverse commissioning). |
| 1874 | Joint Fabric Datastore | Joint Fabric datastore: shared data (groups, nodes, ACLs) for a fabric jointly administered by several ecosystems. |
| 1875 | Joint Fabric Administrator | Joint Fabric administrator: manages joint-fabric relationships and ICAC/NOC issuance. |
| 2049 | TLS Certificate Management | TLS certificate management: provisioning of root and client certificates for TLS-based features (cameras, push A/V). |
| 2050 | TLS Client Management | TLS client management: TLS endpoints a node may connect to. |
Locks, closures, HVAC and lighting
| Decimal | Cluster | Description |
|---|---|---|
| 6 | On/Off | Basic binary control for turning a device or feature on or off. See the Cluster 6 page. |
| 8 | Level Control | Controls a numeric level such as brightness, fan level, or any stepped/continuous output. See the Cluster 8 page. |
| 59 | Switch | Switch input events: initial press, release, long press, multi-press, latching switch position. |
| 257 | Door Lock | Door lock: lock state, lock type, users, PIN/RFID credentials, schedules, auto-relock, lock events. |
| 258 | Window Covering | Window covering: blinds, shades, curtains; lift and tilt position, operational status, limits. |
| 260 | Closure Control | Closure control: generic open/close/stop motion for doors, gates, and other closures. |
| 261 | Closure Dimension | One controlled dimension of a closure (position, latch, speed) used by Closure Control. |
| 512 | Pump Configuration and Control | Pump control: operation mode, control mode, setpoints, pressure/flow/speed, pump status and alarms. |
| 513 | Thermostat | Thermostat: heating/cooling setpoints, system mode, schedules, occupancy, presets, running state. Revision 11 in 1.6.1. |
| 514 | Fan Control | Fan control: fan mode, percent/speed setting, rock, wind, airflow direction, step. |
| 516 | Thermostat User Interface Configuration | Thermostat UI configuration: display units and keypad lockout. |
| 768 | Color Control | Color control for lighting: hue, saturation, XY, color temperature, color loops, enhanced hue. |
Sensing and measurement
| Decimal | Cluster | Description |
|---|---|---|
| 69 | Boolean State | Single boolean sensor state (open/closed, wet/dry, detected/clear). Meaning depends on the endpoint device type. |
| 91 | Air Quality | Summarized air quality level (good, fair, moderate, poor, ...) derived from concentration measurements. |
| 92 | Smoke CO Alarm | Smoke and carbon monoxide alarm: alarm states, hush, self-test, interconnect, end-of-service, contamination. |
| 128 | Boolean State Configuration | Configuration for boolean-state sensors: sensitivity level, alarm enable/suppress, sensor fault. |
| 129 | Valve Configuration and Control | Valve control: open/close, target level, open duration, auto-close, valve fault. |
| 1024 | Illuminance Measurement | Measured illuminance (light level). |
| 1026 | Temperature Measurement | Measured temperature. |
| 1027 | Pressure Measurement | Measured pressure. |
| 1028 | Flow Measurement | Measured flow rate. |
| 1029 | Relative Humidity Measurement | Measured relative humidity. |
| 1030 | Occupancy Sensing | Occupancy / presence detection, sensor type, hold time and sensitivity. |
| 1036 | Carbon Monoxide Concentration Measurement | Carbon monoxide concentration and measurement level. |
| 1037 | Carbon Dioxide Concentration Measurement | Carbon dioxide concentration and measurement level. |
| 1043 | Nitrogen Dioxide Concentration Measurement | Nitrogen dioxide concentration and measurement level. |
| 1045 | Ozone Concentration Measurement | Ozone concentration and measurement level. |
| 1066 | PM2.5 Concentration Measurement | PM2.5 fine particulate matter concentration. |
| 1067 | Formaldehyde Concentration Measurement | Formaldehyde concentration and measurement level. |
| 1068 | PM1 Concentration Measurement | PM1 particulate matter concentration. |
| 1069 | PM10 Concentration Measurement | PM10 particulate matter concentration. |
| 1070 | Total Volatile Organic Compounds Concentration Measurement | Total volatile organic compounds (TVOC) concentration. |
| 1071 | Radon Concentration Measurement | Radon concentration and measurement level. |
| 1072 | Soil Measurement | Soil moisture measurement for irrigation and garden devices. |
| 1073 | Ambient Context Sensing (New) | Ambient context sensing: higher-level room context (people present, activity, ambient conditions). New in 1.6. |
Appliances
| Decimal | Cluster | Description |
|---|---|---|
| 72 | Oven Cavity Operational State | Operational state (running, paused, error) for one oven cavity. |
| 73 | Oven Mode | Selects and reports oven operating modes (bake, convection, grill, ...). |
| 74 | Laundry Dryer Controls | Dryer-specific controls such as dryness level. |
| 80 | Mode Select | Generic selectable operating modes for devices without a more specific mode cluster. |
| 81 | Laundry Washer Mode | Washing machine operating modes. |
| 82 | Refrigerator And Temperature Controlled Cabinet Mode | Refrigerator or temperature-controlled cabinet modes (rapid cool, rapid freeze, ...). |
| 83 | Laundry Washer Controls | Washer-specific controls: spin speed, number of rinses. |
| 84 | RVC Run Mode | Robotic vacuum cleaner run modes (idle, cleaning, mapping). |
| 85 | RVC Clean Mode | Robotic vacuum cleaner cleaning modes (vacuum, mop, deep clean). |
| 86 | Temperature Control | Target temperature or temperature level setpoints for appliances. |
| 87 | Refrigerator Alarm | Refrigerator and cabinet alarms such as door open. |
| 89 | Dishwasher Mode | Dishwasher operating modes. |
| 93 | Dishwasher Alarm | Dishwasher-specific alarms and faults (inflow, drain, door, temperature, water level). |
| 94 | Microwave Oven Mode | Microwave oven operating modes. |
| 95 | Microwave Oven Control | Microwave cooking parameters: cook time, power setting, wattage. |
| 96 | Operational State | Generic operational state (stopped, running, paused, error) for devices that run a process. |
| 97 | RVC Operational State | Robotic vacuum cleaner operational state, errors, and phase. |
| 100 | Temperature Alarm (New) | Temperature alarm states (too hot / too cold) for appliances and cabinets. New in 1.6. |
| 113 | HEPA Filter Monitoring | HEPA filter condition, change indication, replacement product list, and reset. |
| 114 | Activated Carbon Filter Monitoring | Activated carbon filter condition, change indication, replacement product list, and reset. |
| 121 | Water Tank Level Monitoring | Water tank level condition and change indication. |
| 336 | Service Area | Service areas and maps a device (for example a robot vacuum) can operate in; select areas and report progress. |
Energy and metering
| Decimal | Cluster | Description |
|---|---|---|
| 144 | Electrical Power Measurement | Electrical power measurement: voltage, current, active/reactive/apparent power, frequency, harmonics, power factor. |
| 145 | Electrical Energy Measurement | Electrical energy measurement: cumulative and periodic imported/exported energy. |
| 148 | Water Heater Management | Water heater management: heater types, heat demand, tank volume, estimated hot water, boost. |
| 149 | Commodity Price | Commodity (energy) price information and forecast from the supplier. |
| 151 | Messages | Device-to-user messages with optional responses and acknowledgement. |
| 152 | Device Energy Management | Device energy management: ESA type/state, power adjustment, forecast, start-time adjustment, pause/resume. |
| 153 | Energy EVSE | Electric vehicle supply equipment: charging state, enable charging/discharging, limits, session info. |
| 155 | Energy Preference | Energy preferences: balance between comfort and efficiency, low-power mode sensitivity. |
| 156 | Power Topology | Power topology: which endpoints a power measurement covers (tree/node/set topology). |
| 157 | Energy EVSE Mode | EVSE charging modes (manual, time of use, solar). |
| 158 | Water Heater Mode | Water heater modes (off, manual, timed). |
| 159 | Device Energy Management Mode | Device energy management modes (no optimization, device/local/grid optimization). |
| 160 | Electrical Grid Conditions | Electrical grid conditions (carbon intensity, grid stress) for energy management decisions. |
| 1792 | Commodity Tariff | Commodity tariff information: tariff periods, prices, components, calendar. |
| 2822 | Meter Identification | Meter identification: meter type, point of delivery, utility name and power threshold. |
| 2823 | Commodity Metering | Commodity metering: metered quantity, tariff unit, and max measured value for the commodity. |
Media
| Decimal | Cluster | Description |
|---|---|---|
| 1283 | Wake On LAN | Wake on LAN: MAC address for waking a media device over the network. |
| 1284 | Channel | Media channel list, current channel, channel change and program guide. |
| 1285 | Target Navigator | Navigates media targets such as inputs, apps, or menu destinations. |
| 1286 | Media Playback | Playback control: play, pause, stop, seek, next/previous, playback speed and state. |
| 1287 | Media Input | Media input selection (HDMI, AV, ...). |
| 1288 | Low Power | Requests a media device to enter low-power/standby mode. |
| 1289 | Keypad Input | Remote-control keypad input: arrows, select, back, numbers. |
| 1290 | Content Launcher | Launches or searches content on a media device or app. |
| 1291 | Audio Output | Audio output selection (speakers, HDMI, Bluetooth). |
| 1292 | Application Launcher | Launches applications on a media device. |
| 1293 | Application Basic | Basic information about an application running on a media device. |
| 1294 | Account Login | Account login/logout flows for content applications. |
| 1295 | Content Control | Content control: parental ratings, screen time, block lists. |
| 1296 | Content App Observer | Content app observer: status and messages from a content application. |
Cameras
| Decimal | Cluster | Description |
|---|---|---|
| 1360 | Zone Management | Zone management for cameras and sensors: detection zones, triggers, sensitivity. |
| 1361 | Camera AV Stream Management | Camera audio/video stream management: stream allocation, codecs, resolution, snapshots. |
| 1362 | Camera AV Settings User Level Management | User-level camera settings: pan/tilt/zoom position and presets. |
| 1363 | WebRTC Transport Provider | WebRTC transport provider: offer/answer/ICE handling to stream camera video to a peer. |
| 1364 | WebRTC Transport Requestor | WebRTC transport requestor: peer side of the WebRTC session setup. |
| 1365 | Push AV Stream Transport | Push A/V stream transport: pushes recorded clips/streams to a destination (for example cloud storage). |
| 1366 | Chime | Chime: selectable chime sounds and play-chime command for doorbells. |
Global attributes (every cluster)
These attribute IDs exist in every cluster and are the last segment of many shadow paths.
| Decimal | Attribute | Meaning |
|---|---|---|
| 65528 | GeneratedCommandList | Command IDs the server can generate (responses). |
| 65529 | AcceptedCommandList | Command IDs the server accepts. |
| 65531 | AttributeList | Attribute IDs the server implements. |
| 65532 | FeatureMap | Bitmap of optional features implemented. |
| 65533 | ClusterRevision | Cluster revision the device implements. |
Related pages
- Matter Bridge Clusters — Detailed Reference
- Every cluster in the tables above links to its own page under the Matter Clusters tab.
Was this page helpful?