Locations
Organize your doors and devices into physical spaces.
Overview
Locations are the top-level organizational unit in Hygate. They group your doors and devices so guests and staff can understand where things are. Think of a location as a building, a floor, a room, or any defined physical space.
What Locations Group
Each location can contain:
- Doors — Smart locks from TTLock
- Devices — IoT relays from Shelly
A location represents a physical place. A building might have multiple locations (one per floor), or a single location might contain many doors and devices.
Creating a Location
Step 1: Navigate to Locations
- Go to Locations
- Click Add Location
Step 2: Enter Details
| Field | Required | Description |
|---|---|---|
| Name | Yes | Display name (e.g., "Main Building Lobby", "Floor 3 Laundry Room") |
| Address | No | Physical address for reference |
Step 3: Save
Click Save to create the location. It now appears in your locations list and can accept doors and devices.
Managing Locations
Editing
Click any location to open its detail page:
| Action | Description |
|---|---|
| Rename | Change the location name |
| Update Address | Change or add the address |
| Add Doors | Link TTLock locks to this location |
| Add Devices | Link Shelly devices to this location |
Viewing Contents
The location detail page shows all doors and devices assigned to it:
- Count of doors and devices
- Status of each door and device
- Quick links to manage each item
Deleting
Click Delete Location to remove it. All doors and devices within the location become unassigned. They remain in Hygate but are no longer linked to a location.
Tip: Unassigned doors and devices remain accessible from the Doors and Devices list pages.
Role Permissions
| Action | Administrator | Operator |
|---|---|---|
| Create location | Yes | No |
| Delete location | Yes | No |
| Rename location | Yes | Yes |
| Update address | Yes | Yes |
| Add/remove doors | Yes | No |
| Add/remove devices | Yes | No |
Operators can rename and update address details, which is useful for correcting typos or updating information without needing admin access.
Naming Conventions
Good location names make it easy for everyone to understand the workspace.
| Good Names | Why |
|---|---|
| "Downtown Property - Floor 1" | Specific + location + floor |
| "Airport T1 - Locker Bay A" | Venue + terminal + zone |
| "Beach Club - Main Entrance" | Venue + specific area |
| "Co-living Building B - Dryers" | Property + zone + type |
| Avoid | Why |
|---|---|
| "Location 1" | Too generic, hard to identify |
| "Locker Room" | Missing building or zone context |
| "Test" | Confusing in production |
Best Practices
Multi-Location Setup
| Approach | Best For |
|---|---|
| One location per building | Small properties with few doors/devices |
| One location per floor | Multi-floor buildings where floors are distinct |
| One location per zone | Large venues with defined sections |
| One location per device type | Properties with many of the same device (e.g., a laundromat) |
Location Hierarchy
If you have many locations, consider a naming hierarchy that makes filtering easy:
- Prefix with city or region: "Berlin - Main Entrance"
- Include building identifier: "Property-A - Floor 2 - Dryers"
- Separate with dashes for easy scanning
Reporting by Location
Use the Reports module with location filters to compare revenue across your properties. Consistent location names make this analysis meaningful.
Troubleshooting
Door or Device Won't Assign to Location
| Check | Action |
|---|---|
| Location exists | Create the location first |
| Door/device already assigned | Check the Doors/Devices list |
| Role permissions | Operators cannot assign — only admins can |
Location Name Conflicting
Each location name should be unique enough to avoid confusion. Hygate does not enforce unique names, but for clarity, choose distinct names.