Update setting

Use this action to update a setting on a VIZIO SmartCast device. You need to know the type and name of the setting you want to change.

You can find these in the SmartCast app, under the device settings for your device. The setting type is the lowercase version of the first menu item you select, such as display, audio, or system. The setting name is what you see in the app, in lowercase and with spaces replaced by underscores, so “AV delay” becomes av_delay.

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 update a setting from an automation or a script:

1. Go to Settings > Automations & scenes.
2. Open an existing automation or script, or select Create automation > Create new automation.
3. If you’re setting up a new automation, add a trigger in the When section. Scripts don’t need a trigger. They run when something else calls them.
4. In the Then do section, select Add action.
5. From the search box, search for and select VIZIO SmartCast: Update setting.
6. Select what you want to control. Under By target (see Targets), select your VIZIO media player entity.
7. Enter the Setting type, Setting name, and New value.
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 vizio.update_setting. A basic example looks like this:

action: vizio.update_setting
target:
  entity_id: media_player.vizio_smartcast
data:
  setting_type: audio
  setting_name: eq
  new_value: Music

This sets the audio equalizer preset to “Music”.

Options in YAML

Targets of the action

This action requires a target. The target is the object of the action. You can point the action at a single 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], a device, an area, a floor, or a label, and Home Assistant will run the action on every matching media_player entity behind that target.

• Entity: one specific media_player entity, such as media_player.living_room.
• Device: every media_player entity that belongs to a device.
• Area: every media_player entity in a room or area.
• Floor: every media_player entity on a floor.
• Label: every media_player entity that shares a label.

You can also select different target types in one action. For example, you can add a specific entity and an area as targets in the same action to run the action on both of them at once.

Try it yourself

Ready to test this? Open Developer 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.

More examples

Real scenarios where this action shows up in automations and scripts. Copy any example and adapt it to your setup.

Automation: switch the equalizer when a movie starts

This automation switches the TV’s audio equalizer to the “Movie” preset whenever the VIZIO media player starts playing, giving you better sound for films.

• Trigger: The VIZIO media player starts playing
• Action: VIZIO SmartCast: Update setting

alias: "VIZIO movie equalizer"
triggers:
  - trigger: state
    entity_id: media_player.vizio_smartcast
    to: "playing"
actions:
  - action: vizio.update_setting
    target:
      entity_id: media_player.vizio_smartcast
    data:
      setting_type: audio
      setting_name: eq
      new_value: Movie

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.