> ## Documentation Index
> Fetch the complete documentation index at: https://developers.uqpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Locations (Acquiring)

> The merchant dashboard Payment > Terminal > Locations page — manage the physical locations where POS devices are placed: view the location list, search/filter by status, and add, edit, delete locations or view a location's details (assigned devices, activity log).

## What this is

This is the **Locations** page under **Terminal** in the **Payment** module of the merchant dashboard (navigation path: Payment → Terminal → Locations). A location is a physical place where you've placed POS devices to accept payments (such as a storefront, office, or outlet). Here you view all locations on the account, filter by status and keyword, add, edit, and delete locations, and open a location to see its address, timezone, assigned devices, and activity log. Use this page to set up a new location, maintain a location's address, or check which devices are assigned to a location.

## Steps

View the location list:

1. Go to **Payment** → **Terminal** → **Locations** tab.
2. The list shows all locations on the account by default; narrow it down using the **Status** filter or **Search** (by name, address, or ID) at the top.

Add a location:

1. Click **Add location** in the top right of the page.
2. In the dialog, enter **Name**, **Address Line 1**, **City**, **Country** (all required); **Address Line 2** is optional.
3. Select **Timezone** (required, from a dropdown).
4. Click **Add Location** to submit. Missing required fields trigger "Please fill in all required fields"; success shows "Location added."

Edit a location:

1. Open the **⋯** menu on a row and click **Edit**, or open the location's details first and click **Edit** in the top right.
2. Update Name, Address Line 1, City, Country, or Timezone; Name, Address Line 1, and Timezone are required.
3. Click **Save Changes**; success shows "Location updated."

Delete a location:

1. Open the **⋯** menu on a row and click **Delete**.
2. Confirm in the dialog ("Are you sure you want to delete this location? This action cannot be undone."), then click **Delete** to confirm.

View a location's details: click a row (or **⋯** → **View details**) to slide in the detail panel, showing Location ID, status, address, timezone, and creation time, plus **Assigned Devices** and **Activity** sections.

Bulk actions: check multiple rows to reveal an action bar at the top with **Export selected** or **Delete selected**; click **Clear** to deselect.

Export: click **Export** in the toolbar to export the current list as a CSV file.

## Fields and statuses

**List columns:**

| Column        | Meaning (merchant view)                                              |
| ------------- | -------------------------------------------------------------------- |
| Location Name | The location's name                                                  |
| Address       | The location's full address (address line + city + country combined) |
| Devices       | The number of POS devices currently assigned to this location        |
| Status        | The location's current status, see below                             |

**Location status:**

| Status   | Meaning                                    |
| -------- | ------------------------------------------ |
| Active   | Location is enabled and operating normally |
| Inactive | Location is not enabled                    |

**Status bar** (above the list): Total (total locations), Active, Inactive, Total Devices (sum of devices across all locations).

**Add / Edit location fields:**

| Field          | Meaning                                           | Notes                |
| -------------- | ------------------------------------------------- | -------------------- |
| Name           | Location name                                     | Required             |
| Address Line 1 | Street address                                    | Required             |
| Address Line 2 | Apartment, suite, unit, building, etc.            | Optional             |
| City           | The location's city                               | Required when adding |
| Country        | The location's country                            | Required when adding |
| Timezone       | The location's timezone, selected from a dropdown | Required             |

**Location Details panel:**

* **Location Details**: Location ID (copyable), status, address, timezone, creation time.
* **Assigned Devices**: a list of POS devices assigned to this location, each showing ID, name, and online/offline status; shows "No devices assigned to this location" when there are none.
* **Activity**: a timeline of the location's events, such as "Location created" and "Reader assigned"; an active location shows "Currently active."

## Edge cases and troubleshooting

* **List shows "No locations yet"**: the account has no locations yet; the hint reads "Locations will appear here once activity begins." Click **Add location** in the top right to create one.
* **"No locations match your filters"**: the current status/search filter has no matches; the hint reads "Try adjusting your filter criteria." Click **Clear filters** or **Clear all** and try again.
* **Clicking submit while adding/editing does nothing**: usually a required field is missing, triggering "Please fill in all required fields" — complete Name, Address Line 1, and Timezone (plus City and Country when adding) before submitting again.
* **Deletion cannot be undone**: deleting a location shows "This action cannot be undone" — verify the location's name and address before confirming; bulk deletion asks "Are you sure you want to delete N location(s)?"
* **No devices shown in a location's details**: no device has been assigned to that location yet, shown as "No devices assigned to this location."
* **Export fails**: if you see an occasional "Failed to export" message, retry the export later.

## Common questions (Q\&A)

* **Q: Where do I manage locations / how do I get to the location list?** A: Payment → Terminal → Locations — the list shows every location on the account.
* **Q: How do I add a new location?** A: Click **Add location** in the top right of the Locations page, fill in Name, Address Line 1, City, Country, Timezone (required), optionally Address Line 2, then click **Add Location**.
* **Q: What information is required for a location?** A: Name, Address Line 1, City, Country, and Timezone are required; Address Line 2 is optional.
* **Q: How do I change a location's address / name?** A: Open **Edit** from the location's **⋯** menu (or **Edit** in the top right of the detail panel), make your changes, then click **Save Changes**.
* **Q: How do I delete a location? Can it be recovered?** A: Click **Delete** in the location's **⋯** menu and confirm; deletion cannot be undone, so verify the location first.
* **Q: What do the "Active" and "Inactive" location statuses mean?** A: Active = the location is enabled and operating normally; Inactive = the location is not enabled.
* **Q: What does the "Devices" column in the location list mean?** A: The number of POS devices currently assigned to that location; the status bar's **Total Devices** is the sum across all locations.
* **Q: How do I see which devices are assigned to a location?** A: Open that location's details — the **Assigned Devices** section lists the devices assigned to it along with their online/offline status.
* **Q: Can I delete multiple locations at once?** A: Yes — check multiple rows, click **Delete selected**, and confirm.
* **Q: How do I export location data?** A: Click **Export** in the toolbar to export the current list as CSV; or check rows and use **Export selected** to export only those.
* **Q: How do I search for a location by name or address?** A: Use the search box, which supports searching by name, address, or ID.