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 can be added and managed through the user interface at Configuration -> Zones.

Zones can also be configured via configuration.yaml:

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

  - name: Work
    latitude: 32.8753367
    longitude: -117.2474053

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

Configuration Variables

name string Required

The friendly name of the zone.

latitude float Required

The latitude of the center point of the zone.

longitude float Required

The longitude of the center point of the zone.

radius integer (Optional, default: 100)

The radius of the zone in meters.

icon string (Optional)

The icon to show instead of name.

passive boolean (Optional, default: false)

To only use the zone for automation and hide it from the frontend and not use the zone for device tracker name.

To find the latitude/longitude of a certain place you can use Google Maps or Bing Maps. Just right click and copy the coordinates from there (Bing) or click on the “What is here?” (Google)

Home zone

If no configuration is given, the zone integration will create a zone for home. This zone will use location provided in the configuration.yaml file and have a radius of 100 meters. To override this, create a zone configuration in configuration.yaml (see above) and name it ‘Home’. Overriding the Home zone via the UI is not supported.

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 icon that you can find on and prefix the name with mdi:. For example mdi:school, mdi:briefcase, 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.