Identify Cluster

Cluster ID: 0x0003  |  Endpoint: Typically on Endpoint 1 (application endpoint); also commonly found on Endpoint 0 (Root)

Identify triggers a visual or audible indicator on the device (flashing light, beeping, screen blinking, etc.) to help users locate a specific device among many. This Cluster is very small — only 2 attributes and 2 commands — but nearly every Matter device is required to support it.

Attribute Overview

Identify has only two attributes, both mandatory. Click an attribute ID to jump to its detailed description.

IdentifyTime (Remaining Identify Time)

The remaining seconds of the current identify effect. Writing a non-zero value immediately starts identification; the device counts down by one each second until it reaches 0 and stops. Writing 0 immediately stops any ongoing identification.

↑ Back to Attributes

IdentifyType (Identify Method)

A read-only attribute that describes which method the device uses for identification. Different devices have different hardware capabilities — a light bulb flashes its light, a door lock may beep, and a device with a screen may blink its display.

IdentifyTypeEnum Enum Values

↑ Back to Attributes

Commands

The Identify Cluster has two commands, both sent from Client to Server (i.e., from the app to the device). No Timed Interaction is required and there are no access restrictions — they can be sent directly.

Identify — Start Identification (0x00)

Tells the device to begin identification for the specified number of seconds. The device chooses the identify method based on its IdentifyType capability (flashing light, beeping, etc.). After receiving the command, the IdentifyTime attribute is set to the provided value and counts down to 0 each second.

Request example:

{
  "invokeRequests": [{
    "commandPath": {
      "endpointId": 1,
      "clusterId": "0x0003",
      "commandId": "0x00"       // Identify
    },
    "commandFields": {
      "0": 10                   // IdentifyTime = 10 seconds
    }
  }]
}

↑ Back to Commands

TriggerEffect — Trigger Effect (0x40)

Triggers a predefined identify effect. Unlike the Identify command, TriggerEffect specifies an effect type rather than a duration — each effect has its own fixed duration and behavior.

EffectIdentifierEnum Enum Values

EffectVariantEnum Enum Values

Request example (trigger a breathe effect):

{
  "invokeRequests": [{
    "commandPath": {
      "endpointId": 1,
      "clusterId": "0x0003",
      "commandId": "0x40"       // TriggerEffect
    },
    "commandFields": {
      "0": 1,                   // EffectIdentifier = Breathe
      "1": 0                    // EffectVariant = Default
    }
  }]
}

↑ Back to Commands

Example Data

Reading the Identify Cluster attributes of a light bulb device:

{
  // --- Attributes ---
  "0x0": 0,         // IdentifyTime = 0 (not currently identifying)
  "0x1": 2          // IdentifyType = VisibleIndicator (LED indicator light)
}