Cluster Manual

Clusters are the core building blocks of the Matter protocol. Each Cluster defines a set of related Attributes (state fields) and Commands (operations). This manual covers 82 Clusters organized by Matter specification categories. Click a card to view details.

Look up a Cluster by ID

Have a Cluster ID (e.g. 0x0101 or 257 from a log)? Type it in to see which cluster it is and jump to its manual page. A Cluster ID is 4 bytes in full; standard clusters omit the vendor prefix 0x0000. See ID structure.

Try:

Data source: connectedhomeip v1.6.0.0

Lighting3

On/off, brightness, color temperature, and color for lights

On/off control: the most basic control Cluster for toggling devices

Brightness/level control: dimming, fading, and transition time settings

Color control: color temperature, HSV color, XY color coordinates

HVAC4

Thermostats, fans, pumps, and other climate devices

HVAC thermostat: temperature reading, cooling/heating setpoints, system mode, weekly schedules

ThermostatUIConfig

Thermostat display configuration: temperature unit, keypad lockout, schedule visibility

Fan control: speed, mode, oscillation, natural wind, forward/reverse rotation

PumpConfigAndControl

Pump operation: pressure/flow/speed control modes, 17 fault event types

Closures3

Door locks, window coverings, valves, and other open/close devices

Door lock control: lock/unlock, user management, credential management (PIN/fingerprint/NFC)

Window covering/blind control: lift, tilt, percentage positioning

ValveConfigAndControl

Valve management: open/close/timed, opening degree control, fault detection

Sensing & Measurement10

Temperature, humidity, pressure, illuminance, air quality, and other environmental monitoring

TemperatureMeasurement

Temperature sensor: current temperature, measurement range, tolerance

RelativeHumidityMeasurement

Humidity sensor: current relative humidity, measurement range, tolerance

PressureMeasurement

Pressure sensor: kPa readings, extended precision mode

IlluminanceMeasurement

Illuminance sensor: log-encoded lux values, sensor type

FlowMeasurement

Flow sensor: 0.1 m³/h units, liquid/gas flow rate

OccupancySensing

Occupancy detection: PIR, ultrasonic, radar, and physical contact sensors

Air quality index: 7-level assessment (Good to ExtremelyPoor)

CarbonDioxideConcentrationMeasurement

CO₂ concentration measurement: ppm readings, peak/average values, level indication

Pm25ConcentrationMeasurement

PM2.5 fine particle concentration: μg/m³ readings, AQI reference

CarbonMonoxideConcentrationMeasurement

CO (carbon monoxide) concentration: safety thresholds, works with SmokeCOAlarm

Safety & Input4

Alarms, sensor configuration, and physical input devices

Smoke and CO alarm: alarm status, self-test, interconnected alerts

Binary sensor: door/window contacts, water leak detection, and other on/off states

BooleanStateConfiguration

Sensor configuration: alarm modes (audible/visual), sensitivity, alarm suppression

Physical input devices: toggle switches, push buttons, dials, event-driven

Appliances14

Washers, dishwashers, refrigerators, microwaves, robot vacuums, and other smart appliances

Generic mode switching: vendor-defined mode lists, startup default mode

OperationalState

Generic state machine: start/pause/stop/resume, phase progress, error handling

LaundryWasherMode

Laundry washer modes: normal/quick/deep wash, derived from ModeBase

LaundryWasherControls

Laundry washer controls: spin speed selection, rinse count, used with washer mode

Dishwasher modes: normal/heavy/light, derived from ModeBase

DishwasherAlarm

Dishwasher alarms: door not closed, water supply fault, drain fault, temperature fault

RefrigeratorMode

Refrigerator modes: rapid cool/freeze, independent multi-zone control

MicrowaveOvenMode

Microwave oven modes: normal heating, defrost, derived from ModeBase

MicrowaveOvenControl

Microwave oven controls: cooking time, power level, wattage settings

Robot vacuum run modes: cleaning/mapping/idle, one of the RVC trio

Robot vacuum clean modes: deep clean/quick sweep/quiet mode

RvcOperationalState

Robot vacuum state machine: cleaning/returning/charging/docked, GoHome command

HepaFilterMonitoring

HEPA filter monitoring: remaining life, replacement reminder, replacement product info

ActivatedCarbonFilterMonitoring

Activated carbon filter monitoring: gas/odor absorption, lifecycle tracking

Media12

Playback, input, and channel control for TVs, set-top boxes, speakers, and other media devices

Media playback control: play/pause/fast-forward/rewind, progress tracking, audio tracks and subtitles

Input source management: HDMI/USB/AUX switching, input renaming

Audio output management: HDMI/Bluetooth/optical/headphone switching

Channel management: channel list, number-based switching, fuzzy search, program guide

Remote control keys: CEC key code mapping, navigation/number/media keys

ContentLauncher

Content launch entry: URL launch, content search, streaming protocols

TargetNavigator

Content target navigation: app list, jumping between menu pages

ApplicationBasic

Application info: vendor/version/running status, one Endpoint per app

ApplicationLauncher

Application lifecycle: launch/stop/hide apps, current foreground application

Content account authentication: streaming service login/logout, temporary PIN mechanism

Device wake: provides MAC/IPv6 addresses for WoL magic packet wake-up

Device sleep: Sleep command puts media devices into standby, pairs with WoL for wake-up

General6

Device identification, grouping, scenes, binding, access control, and other cross-device capabilities

Device identification: triggers flashing lights or sounds to help locate a device

Endpoint descriptor: lists the Clusters, Device Types, and other info on an endpoint

Group management: device grouping, multicast control, batch operations

SceneManagement

Scene management: attribute snapshots, one-tap switching, gradual transitions

Device binding: defines communication relationships between switches and lights, sensors and controllers

Access control: ACL entries, Privilege levels, Fabric-scoped access management

Node Info & Configuration11

Basic device info, power source, labels, localization, time, and other node-level settings

BasicInformation

Basic information: vendor name, product name, hardware/firmware version, serial number

BridgedDeviceBasicInformation

Bridged device info: Zigbee/Z-Wave devices exposed to Matter through a bridge/gateway

Power source status: battery level, charging state, power supply type

PowerSourceConfiguration

Power source mapping: which Endpoints provide power info, priority order

Factory labels: read-only key-value pairs for device location, orientation, and other factory info

User labels: writable key-value pairs for custom device grouping, ownership, and other metadata

LocalizationConfiguration

Language/locale settings: BCP 47 tags, device interface language switching

TimeFormatLocalization

Time display preferences: 12/24-hour format, calendar type

UnitLocalization

Unit preferences: temperature display unit (Fahrenheit/Celsius/Kelvin)

TimeSynchronization

Time management: UTC setting, timezone/DST, NTP configuration, trusted time source

Low-power devices: SIT/LIT modes, Check-In protocol, client registration

Commissioning & Security5

Device commissioning flow, certificate management, and group multicast keys

NetworkCommissioning

Network commissioning: WiFi/Thread network scanning, connecting, credential management

GeneralCommissioning

Commissioning flow control: FailSafe mechanism, regulatory config, commissioning completion

AdministratorCommissioning

Commissioning window control: open/close pairing mode, enhanced vs. basic commissioning

OperationalCredentials

Certificate management: NOC/CSR/Fabric, multi-admin, certificate rotation

GroupKeyManagement

Group multicast keys: KeySet management, Epoch key rotation, group security policies

OTA & Diagnostics7

Firmware updates, device diagnostics, and network status monitoring

OtaSoftwareUpdateProvider

OTA server: firmware query, download negotiation, update confirmation

OtaSoftwareUpdateRequestor

OTA client: Provider management, update status tracking, progress reporting

GeneralDiagnostics

Device health: network interfaces, uptime, boot reasons, hardware/network faults

SoftwareDiagnostics

Software runtime: heap memory, thread stacks, high watermarks

ThreadNetworkDiagnostics

Thread network: topology role, neighbor table, route table, TX/RX counters

WiFiNetworkDiagnostics

WiFi connection: RSSI, security type, beacon loss, association failures

EthernetNetworkDiagnostics

Ethernet connection: PHY rate, full duplex, TX/RX packet counts, collisions

Energy Management3

Electrical power measurement, energy metering, and smart energy scheduling

ElectricalPowerMeasurement

Real-time power: voltage/current/active/reactive/apparent power, harmonic analysis

ElectricalEnergyMeasurement

Cumulative energy: imported/exported energy, periodic measurement, bidirectional metering

DeviceEnergyManagement

Energy scheduling: power adjustment, load forecasting, constraint optimization, EVSE/heat pump/solar

How to Read Cluster Detail Pages

Each Cluster detail page is organized as follows:

Cluster ID — the hex number in the title. It is 32-bit in full; the upper 16 bits are a vendor prefix (0x0000 for standard clusters, usually omitted). Use the lookup box above to reverse-search
Overview — What the Cluster does and which Endpoint it typically appears on
Attributes — All state fields, grouped by function, with types and enum values annotated
Commands — Supported operations, with parameters and security requirements annotated
Data Examples — Real device JSON data with field-by-field annotations to help you understand