Matter versions

Matter updates often, and the SDK and data API grow with it. Each extension says which versions of Matter it runs on, in matter.json:

{
  "minMatterVersion": "0.4.0",
  "maxMatterVersion": "0.9.0"
}

• minMatterVersion is required: the oldest Matter that can run the extension. matter extension create writes the version you’re on. matter extension deploy stops if it’s missing.
• maxMatterVersion is optional: the newest Matter the extension is known to run on. Leave it out unless a newer Matter breaks your extension.

Versions are three numbers, like 0.4.0.

What members see

A computer outside the range doesn’t open the extension. Instead it shows:

• “Update Matter to use App”, with the version it needs, when its Matter is older than minMatterVersion;
• that the extension doesn’t support this version of Matter yet, when its Matter is newer than maxMatterVersion.

The extension’s worker and run server don’t start there either.

Choosing the range

• Raise minMatterVersion when you start using something a newer Matter added: a new SDK call, a new option. Update @matter.work/extension-sdk for its types (npm install @matter.work/extension-sdk@latest). Members on older versions are asked to update.
• matter extension deploy tells you when the computer you deploy from is outside the range, since you won’t be able to open the extension there.