Get device attribute: device_attr

The device_attr template function returns the value of a specific attribute from a deviceA device is a model representing a physical or logical unit that contains entities. in the device registry. You can pass either a device ID or an entityAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more] ID along with the attribute name you want to retrieve. If the device or attribute doesn’t exist, it returns None.

This is useful when you need device-level information that isn’t available through entity states or attributes. For example, you might want to check the manufacturer, model, software version, or serial number of a device. You could use this to track which devices need firmware updates, build a hardware inventory, or include model information in a support request notification. Common attribute names include manufacturer, model, sw_version, hw_version, serial_number, and identifiers.

Usage

Here’s how to use this template function. Copy any example and adjust it to your setup.

{{ device_attr("a1b2c3d4e5f6a1b2c3d4e5f6", "manufacturer") }}

Philips

{{ "a1b2c3d4e5f6a1b2c3d4e5f6" | device_attr("manufacturer") }}

Philips

Function signature

The signature is a technical summary of this template function. It shows the name of the function, the values (called parameters) it accepts, and what type of data each parameter expects (for example, a piece of text or a number).

Function parameters that have a = with a value after them are optional. If you leave them out, the default value shown is used automatically. Function parameters without a default are required.

device_attr(
    device_or_entity_id: str,
    attr_name: str,
) -> Any

Function parameters

The following parameters can be provided to this function.

Good to know

• Returns None when the device or attribute does not exist, so chain with | default(value) for display fallbacks.
• This reads from the device registry, not the entity state. Attributes like manufacturer and sw_version live here, not in state_attr.
• Accepts either a device ID or an entity ID. When given an entity ID, it resolves to the device first.

Try it yourself

Ready to test this? Open Developer tools > Template, paste the example into the Template editor, and watch the result update on the right. Edit the values to see how the function adapts to your own entitiesAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more].

More examples

Real scenarios where this function comes up in automations and templates. Copy any example and adapt it to your setup.

Get the model of a device from an entity ID

You can pass an entity ID directly. The function automatically resolves the device behind the entity.

{{ device_attr("light.living_room", "model") }}

LCA001

Check the firmware version of a device

Read the software version to see if a device is up to date.

{{ device_attr("a1b2c3d4e5f6a1b2c3d4e5f6", "sw_version") }}

1.104.2

Include device info in a notification

Send a notificationYou can use notifications to send messages, pictures, and more, to devices. [Learn more] with the manufacturer and model when a device goes offline.

action:
  - action: notify.mobile
    data:
      message: >
        {{ device_name("sensor.garage_door_battery") }} is offline.
        Device:
        {{ device_attr("sensor.garage_door_battery", "manufacturer") }}
        {{ device_attr("sensor.garage_door_battery", "model") }}

Still stuck?

The Home Assistant community is quick to help: join Discord for real-time chat, post on the community forum with your template and expected result, or share on our subreddit /r/homeassistant.

Related template functions

These functions work well alongside this one:

• Test device attribute: is_device_attr - Tests if a specific attribute of a device has a given value.

• Get a device ID: device_id - Returns the device ID for a given entity ID or device name.

• Get a device name: device_name - Returns the name of a device from a device ID or entity ID.

• Get entities for a device: device_entities - Returns a list of entity IDs associated with a given device.