Introduction to Locations

The Locations screen allows you to create location profiles. Teramind will then use the location profile to match a user’s geolocation coordinates and network information (e.g., Wi-Fi SSIDs) to determine if the user is in a particular location, such as working from home or located in a certain branch office, etc.

For general information about geolocation tracking, how it works, OS setup, and answers to frequently asked questions, see this article in the Knowledge Base.

To learn how Teramind determines In-Office vs. Out-of-Office status using geolocation and access points - including detection priority rules, 15-minute bucket logic, and best practices for accurate location reporting - check out this article.

1. Search: Use this search field to filter the locations list matching your keywords.

2. Access Point Filter: Click this dropdown to filter the locations list by access point type. Select Any access point to show all locations.

3. New Location: Click the New Location button to create a new location. See the Creating a New Location section below for details.

4. Grid Menu: Click the Grid icon to select which columns are shown on the locations table. Here are the available columns and their descriptions:

Location: The location's display name.
Address: The location's street address.
Postcode: The location's postal code. Hidden by default.
Access Points: The number of access points registered for the location.
Radius: The location's radius, in meters. Hidden by default.
Coordinates: The location's latitude and longitude. Hidden by default.

5. Context Menu: Click the Three Dots ⋮ in front of a location to access its context menu. From the context menu, you can:

Edit Location – to edit the location's general info and access points. You can also edit a location by clicking its name. Editing a location is similar to creating a new location.
Clone Location – to create a copy of the location, including its access points.
Delete Location – to permanently delete the location. A confirmation dialog will ask you to confirm.

Creating a New Location

Click the New Location button near the top-right corner of the Configurations > Locations screen. A panel will open with two tabs - General Info and Access Points:

General Info

On the General Info tab, define where the location is: its name, address, and the geographic position (with a radius around it) that Teramind matches against employee geolocation data:

1. Location Name: Give the location a name (required).

2. Address: Enter the location's street address.

3. Map: Allows you to pick a location visually:

a. Click on the map to drop a pin at the location. This fills in the Latitude and Longitude fields automatically.

b. Use the + / − buttons to zoom.

4. Latitude: You can manually enter the latitude if you didn’t pick a location from the map.

5. Longitude: You can manually enter the longitude if you didn’t pick a location from the map.

6. Radius: Select the location's radius from the dropdown. Teramind considers an employee to be at this location when their geolocation falls within this radius of the coordinates.

7. Postcode: Enter the location's postal code.

8. Save/Continue: At this point, if you don’t want to add any access points to the location profile, you can click Save button to save the location and close the panel. Otherwise, click the Access Points tab to continue.

Access Points

On the Access Points tab, register the location's network access points (Wi-Fi networks, routers, IP ranges). Teramind uses these to recognize the location from the employee's network connection - a reliable fallback when geolocation is unavailable or imprecise:

1. Add Access Point: Click the Add Access Point button. The Add Access Point form will open:

a. Fill in the access point's details:

Name: A name for the access point (required) - for example, “Head Office Wi-Fi” or “Floor 1 Router”.
SSID: The Wi-Fi network name, exactly as it is broadcast - for example, “CorpNet-Office” or “Jim's Wi-Fi”. Used as a readable label only; the agent does not match on it. Always fill in the Mac Address for Wi-Fi detection to work.
Mac Address: The access point's MAC address (its BSSID) - for example, 56-B3-D0-63-C2-26 or 56:B3:D0:63:C2:26 (both hyphen and colon formats are accepted). This is the strongest identifier: the agent matches visible Wi-Fi access points by MAC address first, before any other network signal.
CIDR: The network range in CIDR notation - for example, 10.52.52.0/24 for the office subnet, or 102.10.22.55/32 for a single address. IPv4 (prefix /0 to /32) and IPv6 (prefix /0 to /128) are both supported. The agent's own adapter addresses are matched against these ranges; when several locations' ranges overlap, the most specific (longest) prefix wins.
Public IP: The network's public (external) IP address - for example, 55.33.44.11. Useful when every employee at a site connects through one shared outbound IP. IPv4 and IPv6 are both accepted.

You don't need to fill in every field - enter whichever identifiers you know. The more you provide, the more reliably Teramind detects the location: the agent checks the Mac Address first, then the CIDR and Public IP.

b. Click Apply to add the access point to the list, or Discard to abandon it.

Repeat Step 1 (a-b) to add as many access points as you need.

2. Existing Access Points: Access points you add appear as cards at the top of the tab, each showing the access point's name and network details. Click the Edit icon on a card to change the access point, or the Trash Can icon to remove it.

3. Click Save to create the location. Note that the Save button stays disabled until the required fields are filled in - and while an access point form is still open, so click Apply or Discard first.

Using Locations with Dashboards and Widgets

The locations you create under Configurations > Locations are not just an organizational list - they become office dimensions/columns across the dashboards and widgets. Once a location exists, Teramind continuously works out which office each monitored device was in, and you can filter and break down user activity by that assignment.

How Teramind Assigns an Office

For every monitored device, Teramind resolves the office in two independent ways, using what you defined on the location:

Office by Network	The device connects through one of the location's access points - a public IP address, a CIDR range, or a MAC address.
Office by Geolocation	The device's reported GPS coordinates fall inside the location's radius (the geofence you set on the General Info tab).
Office	The effective office: the network match is used when one exists, otherwise the geolocation match. Use this when you don't care how the device was placed.

Devices that match no location are reported as Out-of-office. For the full detection logic (precedence, refresh cadence, and edge cases such as VPNs), see the Knowledge Base article How In-Office/Out-of-Office Detection Works in Teramind.

Using the Geolocation Dashboard

The built-in Geolocation dashboard is the location-native view: a map of activity plus breakdowns by country, region, and city. You can also use Office locations and filters, so it doubles as the quickest way to sanity-check a new location: create it, open the Geolocation dashboard, and confirm the expected devices land inside it.

Filtering a Dashboard/Widget by Office

You can apply one or more locations filters to most dashboards using the Filters button.

Using Office Dimensions/Columns in Widgets

You don't need a special data source to get office breakdowns. Office locations are standard fields available for most of the data sources. Any widget built on one of those data sources can use them.

Chart Widgets

the office fields appear in the Dimension picker, so you can chart activity per office (e.g. a bar chart of productive hours by Office):

Grid Widgets

Open the widget's Grid menu and tick Office, Office by Geolocation, or Office by Network to show them as columns, so each activity row shows which office the employee was in:

If a data source doesn't offer the office fields, that source doesn't support location breakdown. A practical use for showing all three columns side by side: auditing location accuracy. A row where Office by Geolocation and Office by Network disagree usually means a stale access point or a VPN.