Picture Card

The Picture card allows you to set an image to use for navigation to various paths in your interface or to call a service.

Screenshot of the picture card Screenshot of the picture card.

To add the Picture card to your user interface, click the menu (three dots at the top right of the screen) and then Edit Dashboard. Click the Add Card button in the bottom right corner and select from the card picker.

YAML Configuration

The following YAML options are available when you use YAML mode or just prefer to use YAML in the Code Editor in the UI.

Configuration Variables

type string Required


image string Required

The URL of an image. When you want to store images in your Home Assistant installation use the hosting files documentation. After storing your files, use the /local path, for example, /local/filename.jpg.

alt_text string (Optional)

Alternative text for the image. This is necessary for users of assistive technology. The W3C images tutorial provides simple guidance for writing alternative text.

theme string (Optional)

Override the used theme for this card with any loaded theme. For more information about themes, see the frontend documentation.

tap_action map (Optional)

Action taken on card tap. See action documentation.

hold_action map (Optional)

Action taken on card tap and hold. See action documentation.

double_tap_action map (Optional)

Action taken on card double tap. See action documentation.


Navigate to another view:

type: picture
image: /local/home.jpg
  action: navigate
  navigation_path: /lovelace/home

Check the views setup on how to setup custom IDs.

Toggle entity using a service:

type: picture
image: /local/light.png
  action: call-service
  service: light.toggle
    entity_id: light.ceiling_lights