Get image URL

The Get image URL action retrieves the URLs of images of your vehicle from a specific angle. You can request all available images at once, or pick one or more specific angles.

This action returns response data and does not change anything on your vehicle.

This action does not support targets. In the UI, you are not prompted to choose an area, device, entity, or label.

Using this action from the user interface

If you prefer building automations and scripts visually, Home Assistant walks you through this action step by step. You pick what to target, tweak a few options, and save. No YAML knowledge required.

To get image URLs from an automation or a script:

1. Go to Settings > Automations & scenes.
2. Open an existing automation or script, or select Create to start a new one.
3. If you’re setting up a new automation, add a trigger in the When section. Scripts don’t need a trigger.
4. In the Then do section, select Add action.
5. From the search box, search for and select Volvo: Get image URL.
6. Select the Entry for the vehicle you want the images for.
7. Optionally, select one or more image angles in Images. Leave this empty to get all images.
8. Select Save.

Options in the UI

Using this action in YAML

If you work directly in YAML, or you want to know exactly what Home Assistant does under the hood, this section has the technical reference. It lists the field names you use in YAML, their types, and which ones are required.

In YAML, refer to this action as volvo.get_image_url:

action: volvo.get_image_url
data:
  entry: 01JVJ0RA387MWA938VE8HGXBMJ
  images:
    - exterior_front
    - interior
response_variable: vehicle_images

This retrieves the front exterior and interior image URLs and stores the response in the vehicle_images variable.

Options in YAML

Response data

The action returns a response containing an images list. Each item describes one image that is available for your vehicle:

• type: The angle of the image, for example exterior_front.
• url: The URL where the image can be retrieved.

Only images that actually exist for your vehicle are returned, so the list may be shorter than the angles you requested.

images:
  - type: "exterior_front"
    url: "https://www.example.com/vehicle/exterior_front.png"
  - type: "interior"
    url: "https://www.example.com/vehicle/interior.png"

Try it yourself

Ready to test this? Open Settings > Tools > Actions, search for this action, fill in the fields, and select Perform action. You see what happens on your actual 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] without writing a line of YAML.

Available image angles

• exterior_back
• exterior_back_left
• exterior_back_right
• exterior_front
• exterior_front_left
• exterior_front_right
• exterior_side_left
• exterior_side_right
• interior

Response data

The action response contains the requested image URLs.

Good to know

If you leave images empty, the action retrieves all available image URLs for the selected vehicle.

current

Still stuck?

The Home Assistant community is quick to help: join Discord for real-time chat, post on the community forum with the action you’re calling and what you expected to happen, or share on our subreddit /r/homeassistant.