Integration category
What an integration is for, like Lighting or Energy, so people can find it by what it does, like on the integrations page of the website.
- In code
categoriesha_categories- Also
- integration categories
An integration lists one to three categories in the categories key of its manifest. Every integration in core has them, except entity, system, and virtual integrations. For a custom integration, they are optional. The documentation page of an integration in core lists the same ones in ha_categories, in its front matter on home-assistant.io. A category can have subcategories, like energy.ev_charging. Integration categories has all of them, and how to choose.
Home Assistant uses the word category for other things too. They are not the same:
- The categories created in Home Assistant itself, to organize automations, scripts, scenes, and helpers. Those live in the category registry, and are the same for everyone using that Home Assistant.
- An entity category marks an entity as configuration or diagnostic.
- In the Marketplace and the HACS action,
categoryis the type of repository: an integration, a dashboard plugin, a theme, or a template.