The On/Off cluster (0x0006) is a Matter cluster that Controls the on/off state of a device. The most fundamental control cluster used by lights, switches, plugs, and many other devices.. It defines 6 commands and 5 attributes and is mandatory for 29 device types.

Last updated 25 Sep 2026

On/Off 0x0006

Application Cluster

General

Introduced in: Matter 1.0

Devices: 484

Controls the on/off state of a device. The most fundamental control cluster used by lights, switches, plugs, and many other devices.

Spec History

This cluster's ClusterRevision across the Matter releases it has shipped in. Click a version to inspect the cluster as it existed in that release.

Matter 1.0 rev 4 Matter 1.1 rev 4 Matter 1.2 rev 5 Matter 1.3 rev 6 Matter 1.4 rev 6 Matter 1.5 rev 6 Matter 1.6 rev 6 Matter master rev 7

Attributes 5

Commands 6

Features 3

Code	Name	Type	Flags
0x0000	OnOff	boolean
0x4000	GlobalSceneControl	boolean	Optional
0x4001	OnTime	int16u	Writable Optional
0x4002	OffWaitTime	int16u	Writable Optional
0x4003	StartUpOnOff max 2 · nullable	StartUpOnOffEnum	Writable Optional write: manage

Code	Name	Direction	Parameters
0x00	Off This command allows devices to be turned off.	client→server	None
0x01	On Optional This command allows devices to be turned on.	client→server	None
0x02	Toggle Optional This command allows devices to be toggled.	client→server	None
0x40	OffWithEffect Optional The OffWithEffect command allows devices to be turned off using enhanced ways of fading.	client→server	`EffectIdentifier`: EffectIdentifierEnum, `EffectVariant`: enum8
0x41	OnWithRecallGlobalScene Optional This command allows the recall of the settings when the device was turned off.	client→server	None
0x42	OnWithTimedOff Optional This command allows devices to be turned on for a specific duration with a guarded off duration so that SHOULD the device be subsequently turned off, further OnWithTimedOff commands, received during this time, are prevented from turning the devices back on.	client→server	`OnOffControl`: OnOffControlBitmap, `OnTime`: int16u, `OffWaitTime`: int16u

Lighting (LT) bit 0

Behavior that supports lighting applications

DeadFrontBehavior (DF) bit 1

Device has Dead Front behavior

OffOnly (OFFONLY) bit 2

Device supports the OffOnly Feature feature

Device Types Using This Cluster

Device types in the Matter spec that reference this cluster

📱

On/Off 0x0006

Spec History

Device Types Using This Cluster

Devices Implementing This Cluster