LocalizationConfiguration Cluster

Cluster ID: 0x002B  |  Endpoint: Endpoint 0 (Root / Node level)

LocalizationConfiguration manages the device's language and regional settings. It enables the controller (App / voice assistant) to query which languages the device supports and switch the device's current language locale. Language tags follow the BCP 47 standard (e.g. "en-US", "zh-CN").

This Cluster is very simple — only 2 attributes, no commands. Language switching is done by directly writing the ActiveLocale attribute.

Attribute Overview

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

ActiveLocale (Current Language Region)

The device's currently active language locale tag, in BCP 47 format (e.g. "en-US", "zh-CN"). Writing a new value switches the device language, but the written value must be in the SupportedLocales list; otherwise the device will return CONSTRAINT_ERROR.

Write example (switching device to Simplified Chinese):

{
  "writeRequests": [{
    "attributePath": {
      "endpointId": 0,
      "clusterId": "0x002B",
      "attributeId": "0x00"        // ActiveLocale
    },
    "attributeValue": "zh-CN"      // Switch to Simplified Chinese
  }]
}

↑ Back to Attributes

SupportedLocales (Supported Language List)

Read-only attribute, returning the list of all language locale tags supported by the device. List content is determined by device firmware; Apps cannot modify it. Before switching languages, read this attribute first to confirm the device supports the target language.

↑ Back to Attributes

Commands

LocalizationConfiguration Cluster does not define any commands. All operations are done through direct attribute reads/writes — read SupportedLocales to check supported languages, write ActiveLocale to switch language. This is one of the simplest interaction patterns in Matter.

Example Data

Reading LocalizationConfiguration Cluster attributes of a smart door lock device:

{
  // --- Attributes ---
  "0x0": "en-US",           // ActiveLocale = current language locale
  "0x1": [                  // SupportedLocales = device supported language list
    "en-US",
    "zh-CN",
    "zh-TW",
    "ja-JP",
    "ko-KR",
    "de-DE",
    "fr-FR"
  ]
}

Real-world Scenarios