Skip to main content

Catalog

The KNX Clarity catalog is a shared, read-only library of KNX manufacturers and products. It is used in two places:

  • During planning — browse manufacturers and products to pick hardware for a new installation.
  • Inside a project — every device extracted from an ETS upload is automatically matched against the catalog, so the device drawer can show the product image, datasheet, and notes without the integrator having to dig them up manually.
Catalog browse page showing a sidebar list of manufacturers on the left and a grid of product cards on the right, each with a product image, model name, and category tag.

Scope​

The catalog is global — every KNX Clarity user sees the same catalog regardless of which organisation they belong to. It is curated by a small group of KNX Clarity editors who have access to the admin-only import and crawl tooling.

That means:

  • You cannot add a product to the catalog yourself. If a product is missing, send us the manufacturer part number via the in-app feedback form and we'll add it.
  • You cannot delete or edit a catalog entry. A correction request follows the same feedback flow.
  • Catalog data does not include pricing — it is a technical reference, not a shop.

Browsing​

Click Catalog in the top navigation (not in the org sidebar — the catalog is global). The page has three levels:

  1. Manufacturers — left sidebar. Alphabetical, with a count of products per manufacturer.
  2. Products — main grid. Filterable by category, datapoint type, and free-text search.
  3. Product detail — click a card to see the full spec, datasheet PDF link, manufacturer homepage link, and a list of every deviceType that typically maps to this product.

Automatic matching inside a project​

When you upload an ETS file, the parser extracts each device's manufacturer string and model string from the ETS XML. The backend then tries to find a single catalog product whose manufacturer and name match. If there is exactly one match, it is linked to the device row and shown in the device drawer. If there is no match (typical for very new or very old hardware), the device drawer shows a "No catalog match" state with a link to report the missing product.

Device drawer showing a catalog match with the product image on the left, the model name and category on the right, and a link 'View in catalog'.

The search input at the top of the catalog supports:

  • Free text across manufacturer, product name, and category.
  • An exact part number lookup — paste a MTN… or 6197/22… string and it goes straight to the product detail if there's a unique match.

Search is implemented against the Aurora-backed catalog tables (not a separate search engine), so very long result lists are paginated server-side.

For catalog admins​

If your Cognito user is in the catalogAdmin group, you'll see an extra Admin catalog page under the catalog menu. It lets you:

  • Upload a catalog import file (YAML or JSON).
  • Kick off a manufacturer crawl (we scrape public datasheets).
  • Review pending updates before they become visible to users.

This tooling is intentionally locked behind a Cognito group — it is not available to regular org members.