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

# Locations

> Add and manage the physical branches of your business so Qtap can track where stamps and points are issued.

Each location in Qtap represents a physical branch of your business. Locations appear in analytics, can be assigned to QR codes, and show up on your merchant page so customers can find you.

Your plan determines how many active locations you can have. The **Add Location** button shows your current limit and disables when you've reached it.

<Frame caption="Settings → Locations lists every branch with its address, GPS Set badge, and Active status.">
  <img src="https://mintcdn.com/qtap/u3vN12its3a6NSzP/images/merchants/settings/locations-01-list.png?fit=max&auto=format&n=u3vN12its3a6NSzP&q=85&s=08d807304d3074b8debc447323d498fd" alt="Locations page listing three branches, each with a GPS Set badge and an Active status, and the Add Location button" width="1440" height="900" data-path="images/merchants/settings/locations-01-list.png" />
</Frame>

## Add a location

<Steps>
  1. Go to **Settings → Locations**.
  2. Click **Add Location**.
  3. Enter a **Location Name** — this is what staff and members see (e.g., "Main Branch", "City Centre Mall").
  4. Use the **Location on Map** picker to place a pin. This saves GPS coordinates for the branch. Qtap fills in the address fields automatically when you pick a point.
  5. Check or fill in **Address Line 1**, **City**, and **Country**.
  6. Add a **Phone** number if you want it shown on your merchant page.
  7. Click **Upload** next to **Location Logo** to add a branch photo or logo.
  8. Enter a **Google Rating** between 0 and 5 to show your rating on the merchant page.
  9. Set **Opening Hours** for each day. Toggle a day off if the branch is closed that day.
  10. Leave the **Active** toggle on.
  11. Click **Add Location**.
</Steps>

<Frame caption="The Add Location form: name the branch, drop a pin on the map, and fill in the address.">
  <img src="https://mintcdn.com/qtap/u3vN12its3a6NSzP/images/merchants/settings/locations-02-add-dialog.png?fit=max&auto=format&n=u3vN12its3a6NSzP&q=85&s=3af4b399e9b26c1b11721920a3be2bd0" alt="Add Location dialog with the Location Name field, map picker, and address fields" width="692" height="830" data-path="images/merchants/settings/locations-02-add-dialog.png" />
</Frame>

<Note>
  The map picker accepts a typed address. If dropping a pin manually is awkward, type the branch name or street address into the search field instead.
</Note>

## Edit a location

Click the three-dot menu on any location card and choose **Edit**. The same form opens with your existing details. Click **Update Location** to save.

<Frame caption="The three-dot menu on each location card holds Edit and Delete.">
  <img src="https://mintcdn.com/qtap/u3vN12its3a6NSzP/images/merchants/settings/locations-03-card-menu.png?fit=max&auto=format&n=u3vN12its3a6NSzP&q=85&s=2c6b6e19b18d1b006d0b4665373a46ff" alt="Location card menu showing Edit and Delete options" width="172" height="118" data-path="images/merchants/settings/locations-03-card-menu.png" />
</Frame>

## Delete a location

Click the three-dot menu and choose **Delete**. Deletion is permanent. QR codes that were assigned to that location will no longer filter by branch, but all existing stamp and points history is kept.

## Active and inactive locations

The **Active** toggle controls whether a location counts toward your plan limit and shows up in the dashboard and on your merchant page.

Toggling a location inactive is useful when a branch is temporarily closed. You can reactivate it at any time without losing any data.

<Warning>
  Your plan has a cap on active locations. If you hit the limit, the Add Location button shows "Location Limit (n)" and you won't be able to add more without upgrading your plan or deactivating an existing branch.
</Warning>

## GPS badge

A location card shows a green **GPS Set** badge when coordinates are saved. Without GPS, the branch won't appear correctly on customer-facing maps.

Click **View on Google Maps** on any card to confirm the pin is placed correctly.

<CardGroup cols={2}>
  <Card title="QR Codes" href="/merchants/qr-codes/overview">
    Assign QR codes to specific locations to track stamps by branch.
  </Card>

  <Card title="Analytics: Location Comparison" href="/merchants/analytics/location-comparison">
    Compare stamp and member activity across all your branches.
  </Card>
</CardGroup>
