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

# Manage Your Store Locations, Hours, and GPS Check-In

> Add branches, opening hours, GPS coordinates, and social links to your app's location directory — and enable loyalty check-ins via geofencing.

The Locations module gives every branch, shop, pickup station, or service point its own entry in your app. Customers can browse your location directory, tap to start navigation, call or email directly from the listing, and check in on arrival to earn loyalty points. Keeping your location data accurate and complete is one of the simplest ways to reduce friction between a customer discovering your business in the app and walking through your door.

## Configuration Reference

| Field             | Description                                                                                                               |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------- |
| **Name**          | The display name of the location (e.g. "Hamburg Altona" or "Flagship Store").                                             |
| **Image**         | A photo of the storefront or facade — helps customers identify the location on arrival.                                   |
| **Homepage URL**  | Link to the location's own website or a landing page, if applicable.                                                      |
| **Phone**         | Clickable phone number; tapping it opens the device dialler.                                                              |
| **Email**         | Mailto link; tapping it opens the device mail client.                                                                     |
| **Address**       | Full street address (street, postal code, city) — used to generate a Maps navigation link.                                |
| **Latitude**      | GPS latitude coordinate for navigation accuracy and check-in geofencing.                                                  |
| **Longitude**     | GPS longitude coordinate for navigation accuracy and check-in geofencing.                                                 |
| **Description**   | Free text for additional details: parking instructions, entrance notes, special features.                                 |
| **Facebook**      | Facebook page URL for the location.                                                                                       |
| **Instagram**     | Instagram profile URL for the location.                                                                                   |
| **Opening hours** | Regular weekly opening hours displayed in the app.                                                                        |
| **Pickup times**  | Click & Collect collection windows — only populate if this location offers Click & Collect.                               |
| **Closed times**  | Holiday or vacation closures that override the regular opening hours.                                                     |
| **Lager / Stock** | Indicates whether this location holds inventory for the Shop module, enabling product availability filtering by location. |
| **Segment**       | Restrict location visibility to specific customer segments.                                                               |
| **Client ID**     | Restrict location visibility to specific apps in a multi-brand or franchise setup.                                        |

## Navigation and GPS Check-In

Every location with a complete **Address** automatically displays a **Navigate** button in the app, which opens the device's default maps application. For customers who are new to a location or searching while on the move, this removes all friction from finding you.

GPS check-in works through geofencing: when a customer taps **Check in** on a location detail screen, the app compares their current GPS position to the coordinates you have entered. If they are within the configured check-in radius, check-in succeeds and any associated loyalty reward is granted.

<Tip>
  Enter **Latitude** and **Longitude** coordinates as precisely as possible — ideally by dropping a pin on the exact entrance of your location in Google Maps and copying the coordinates directly. Even a small offset can push the geofence boundary into a road or neighbouring building, causing legitimate check-ins to fail.
</Tip>

## Click & Collect

If your business offers Click & Collect, the **Pickup times** field lets you publish collection windows that are separate from your regular opening hours. Customers placing online orders can see at a glance when they can collect from each location.

The **Lager / Stock** toggle connects this location to your Shop module's inventory system. When enabled, product availability and stock levels for this location become visible in the app, allowing customers to check whether a specific item is in stock before travelling to collect it. Only enable this flag for locations that are actively managed within the Shop module's inventory.

## Audience Filtering

You can restrict individual locations using the same targeting tools available across all Pocketshop content:

* **Segment targeting** — hide a location from general users while keeping it visible to a specific group, such as trade customers with access to a wholesale warehouse or employees who need to see an internal fulfilment depot.
* **Client ID targeting** — in multi-brand or franchise setups, ensure each brand's app only shows its own relevant locations rather than the full network.

Leave both fields empty to show the location to all users across all apps.

## Adding a New Location

<Steps>
  <Step title="Open the Locations module">
    Navigate to **Content → Locations** in your Pocketshop dashboard and click **New location**.
  </Step>

  <Step title="Enter the name and upload an image">
    Give the location a clear, identifiable **Name** and upload a **storefront photo**. A recognisable facade image helps customers confirm they have arrived at the right place.
  </Step>

  <Step title="Add contact details and address">
    Enter the **Phone**, **Email**, and full **Address**. The address will be used to generate the Maps navigation link automatically.
  </Step>

  <Step title="Add GPS coordinates">
    Enter the precise **Latitude** and **Longitude** for the location entrance. Obtain these from Google Maps by right-clicking the exact entrance point and copying the coordinates.
  </Step>

  <Step title="Write a description">
    Use the **Description** field to add anything that helps a customer on arrival: parking instructions, which entrance to use, elevator availability, or any notable features.
  </Step>

  <Step title="Set opening hours and closed times">
    Enter the regular **Opening hours** for each day of the week. Add any known **Closed times** for public holidays, seasonal closures, or staff training days.
  </Step>

  <Step title="Add social media links (optional)">
    If this location has its own **Facebook** or **Instagram** presence, add the profile URLs to give customers a direct path to location-specific content and community.
  </Step>

  <Step title="Configure Click & Collect (if applicable)">
    If this location offers Click & Collect, enter **Pickup times** and enable the **Lager / Stock** toggle if the location's inventory is managed in the Shop module.
  </Step>

  <Step title="Apply filtering (optional)">
    Assign **Segment** and/or **Client ID** values if this location should be restricted to specific audiences or apps.
  </Step>

  <Step title="Save and verify">
    Save the location. Open the app and confirm that the listing, navigation link, and contact details all appear and function correctly.
  </Step>
</Steps>

<Note>
  Keep **Opening hours** and **Closed times** up to date, including short-notice closures and public holiday variations. Customers who rely on the app for opening information and arrive at a closed location have a poor experience — and incomplete hours are one of the most common causes of avoidable negative feedback. Set a recurring reminder to review and update seasonal hours at the start of each quarter.
</Note>
