# Zone Editor

# Zone Editor

The Zone Editor lets you create and manage detection zones for your EPL or Pro sensor. Zones trigger automations when targets enter or exit specific areas of your room.

> **Note**: Zone creation is available for Everything Presence Lite (EPL) and Everything Presence Pro. EP1 devices use distance-based detection instead.

## Accessing the Zone Editor


1. From the Live Dashboard, click the **menu icon** (☰)
2. Select **Zone Editor**

 ![](https://docs.everythingsmart.io/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzL2U1MTYzNjNkLThhMWItNDI0Zi1hOTk5LTI0ZDFmMDUxZDNhZi84OWJhZTk2NS0yNTQxLTRiYWEtODllOS1mYjNkMmRiNDQxNjQvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTM2ODIwMDAsImV4cCI6MTc5Mzc2ODQwMH0.DI6Wj1KvMwpfUJSD3_ZHVPu2_Ej7CTEbF2O1DWxGs3Q)

## Zone Types

### Regular Zones (Detection Areas)

Standard zones that report occupancy when a target is detected inside them. Use these for:

* Lighting control (desk area, seating area)
* Room subdivisions
* Activity-specific triggers

### Exclusion Zones (Occupancy Masks)

Areas where detection should be ignored. The sensor still tracks targets, but they won't trigger occupancy in exclusion zones. Use these for:

* Windows (to ignore passing traffic outside)
* Areas with moving objects (fans, curtains, pets)
* Doorways to adjacent rooms

### Entry Zones

Special zones that track entry and exit events. When combined with Assumed Presence, these enable advanced scenarios like:

* Counting people entering/leaving
* Knowing someone is home even when stationary outside detection range
* Entry notifications

## Drawing Modes

The Zone Editor offers two drawing modes, which can be toggled using the mode buttons at the top of the screen.

### Rectangle Mode

Uses pre-defined zone slots for quick, simple zone creation. This is the default mode.

**Available Slots:**

* **Zone 1-4** - Regular detection zones
* **Exclusion 1-2** - Exclusion zones
* **Entry 1-2** - Entry/exit zones

### Polygon Mode

Allows freeform polygon drawing for complex shapes that don't fit a rectangle.

## Creating Zones

### Creating Zones in Rectangle Mode


1. Click **Show Zone Slots** in the toolbar to reveal the zone slots panel
2. Find the slot you want to use (e.g., "Zone 1" or "Exclusion 1")
3. Click the **Enable** button next to that slot
4. A rectangular zone appears on the canvas at a default position
5. Drag the zone to reposition it
6. Use the corner/edge handles to resize

 ![](https://docs.everythingsmart.io/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzL2U1MTYzNjNkLThhMWItNDI0Zi1hOTk5LTI0ZDFmMDUxZDNhZi8yMWViYmQ3Ny1mNmVlLTQ4NGEtYTA0Yy1lNzE1NmIxNGZmZDYvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTM2ODIwMDAsImV4cCI6MTc5Mzc2ODQwMH0.01x3Yj-4EYX69yfSXKT5bmK0yqVs4BddrVWHGh6sfOA)

### Creating Zones in Polygon Mode


1. Switch to **Polygon Mode** using the mode toggle
2. Click **+ Zone**, **+ Exclusion**, or **+ Entry** button depending on the zone type needed
3. A triangular starter zone appears on the canvas
4. Click on the zone to select it
5. Drag corner points to reshape the polygon
6. Double-click an edge to add new points for more complex shapes

 ![](https://docs.everythingsmart.io/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzL2U1MTYzNjNkLThhMWItNDI0Zi1hOTk5LTI0ZDFmMDUxZDNhZi85Yzg4MjhiYi1kYWJlLTQ5ZDYtYTAzZC0yNDhiMzdkNzdhYmQvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTM2ODIwMDAsImV4cCI6MTc5Mzc2ODQwMH0.QhBL8-LFv_lm-ytxI8_vHrCwyR7CL4yEYEVTRjYP1Es)

### Switching Between Modes

You can switch between Rectangle and Polygon modes at any time. If you have existing zones, a confirmation dialog will appear warning that mode-specific zones may be affected.

## Editing Zones

### In Rectangle Mode


1. Click **Show Zone Slots** to view all zone slots
2. Enabled zones show their current coordinates (X, Y, Width, Height)
3. To adjust a zone:
   * **Drag** the zone on the canvas to reposition
   * **Drag handles** to resize
   * Enter precise values in the slot's coordinate fields
4. To remove a zone, click **Disable** next to its slot

### In Polygon Mode


1. Click on a zone to select it
2. **Drag the zone** to move it
3. **Drag corner points** to reshape
4. **Double-click an edge** to add a new point
5. Use the **Delete** button to remove the zone

### Zone Properties

| Property | Description |
|----------|-------------|
| **Name/Label** | Label shown on the zone (e.g., "Desk", "Sofa") |
| **Type** | Regular, Exclusion, or Entry (determined by slot in Rectangle mode) |
| **X, Y** | Position coordinates (in mm from sensor) |
| **W, H** | Width and Height (in mm) - Rectangle mode only |

## Understanding Coordinates

Zone coordinates are measured in millimeters from the sensor position:

* **X** - Left/right position (negative = left, positive = right)
* **Y** - Distance from sensor (always positive, away from sensor)

## Saving Zones to Device

After creating or editing zones, click **Save to Device** to push the configuration to your device.

> **Important**: Zones are not active until saved to the device. The button highlights when you have unsaved changes.

### What Happens When You Save


1. Zone coordinates are sent to the device via Home Assistant
2. The device firmware processes the zones
3. Zone occupancy entities update in real-time
4. Zones persist on the device (survive restarts)

## Zone Limits

EPL and Pro support:

* **4 regular zones** (Zone 1-4)
* **2 exclusion zones** (Exclusion 1-2)
* **2 entry zones** (Entry 1-2) - EPL only

If you need more coverage:

* Combine smaller areas into larger zones
* Use exclusion zones strategically
* Consider zone placement priority

## Troubleshooting Zones

| Issue | Solution |
|-------|----------|
| Zone not activating | Check target is within zone boundaries on live view |
| Zone always active | Zone may be too large or overlapping sensor position |
| Save fails | Verify device is online and connected |
| Zones reset after restart | Ensure you clicked "Save to Device" |
| Zone activates unexpectedly | Check for exclusion zones to mask false triggers |
| Can't find zone slots | Click "Show Zone Slots" button in toolbar |

## Next Steps

* [Entry/Exit Zones & Assumed Presence](/doc/0383f904-51a7-4f96-8ba5-1b85fbe42f49) - Advanced entry detection
* [Live Dashboard](/doc/695636da-dc42-490b-b5a1-281e96c73381) - Watch zones activate in real-time
* [Room Builder](/doc/dae67af3-d87c-4acb-ba3f-4f85a802d40f) - Add room context for better zone placement

---

**Documents**

- [EP1 vs EPL: Which Sensor is Right for You?](https://docs.everythingsmart.io/s/products/doc/ep1-vs-epl-which-sensor-is-right-for-you-5B3RxiY3Kp)
- [Everything Presence One (EP1)](https://docs.everythingsmart.io/s/products/doc/everything-presence-one-ep1-3R178yZSUP)
- [Everything Presence Pro](https://docs.everythingsmart.io/s/products/doc/everything-presence-pro-nh3fIXmow9)
- [Everything Presence Lite (EPL)](https://docs.everythingsmart.io/s/products/doc/everything-presence-lite-epl-ZVnBzYzuX2)
- [Zone Configurator](https://docs.everythingsmart.io/s/products/doc/zone-configurator-93b9scGsa2)
- [Knowledge Base Articles](https://docs.everythingsmart.io/s/products/doc/knowledge-base-articles-KnRRmk4zvt)