Zones allow you to specify certain regions on earth (for now). When a device tracker sees a device to be within a zone, the state will take the name from the zone. Zones can also be used as a trigger or condition inside automation setups.

Zones support the usual method to specify multiple zones, use keys zone:, zone 2: etc.

# Example configuration.yaml entry
  name: School
  latitude: 32.8773367
  longitude: -117.2494053
  radius: 250
  icon: mdi:school

zone 2:
  name: Work
  latitude: 32.8753367
  longitude: -117.2474053

# This will override the default home zone
zone 3:
  name: Home
  latitude: 32.8793367
  longitude: -117.2474053
  radius: 100
  icon: mdi:account-multiple

Configuration variables:

  • name (Optional): Friendly name of entry.
  • latitude (Required): Latitude of the center point of the zone.
  • longitude (Required): Longitude of the center point of the zone.
  • radius (Optional): Optional radius in meters. Defaults to 100 meters.
  • icon (Optional): Optional icon to show instead of name.
  • passive (Optional): Optional boolean to only use the zone for automation and hide it from the UI and not use the zone for device tracker name. Defaults to false.

Home zone

If no configuration is given, the zone component will create a zone for home. This zone will use location given in the configuration.yaml file and have a radius of 100 meters. To override this, create a zone configuration and name it ‘Home’.

Devices that are in the zone ‘Home’ will not appear on the map in the Home Assistant UI.


It is preferred to pick an icon to use for your zone. Pick any zone that you can find on and prefix the name with mdi:. For example mdi:school, mdi:worker, mdi:home, mdi:cart, or mdi:castle.


zoning is the state a zone has when it is configured. A zone doesn’t have another state, all configured zones are zoning all the time