> For the complete documentation index, see [llms.txt](https://docs.perkville.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.perkville.com/overview/multi-location-businesses-and-franchises.md).

# Multi-location businesses and franchises

Perkville helps multi-location businesses and franchises run a coordinated loyalty and referral program while giving individual locations flexibility to meet local needs. You can share earning rules, promotions, rewards, challenges, and referral offers across your business or configure them for selected locations. Staff access and location groups help you manage the program around your ownership and operating structure.

## Central control with local flexibility

### Business and location program status

[Business program status](https://docs.perkville.com/features/settings/business/business-program-status.md) controls loyalty across the business. [Location program status](https://docs.perkville.com/features/settings/location-setup/locations/location-program-status.md) controls one location.

For staggered rollouts, use **Activate With Business** for locations that should activate on the business activation date. Use **Activate Later** for locations with their own later date. A location can restrict business-level [allowed activities while inactive](https://docs.perkville.com/features/settings/loyalty-activity-controls/allowed-activities-while-inactive.md), but cannot allow more.

Business and location [earliest transaction dates](https://docs.perkville.com/features/settings/loyalty-activity-controls/activation-and-transaction-dates.md) form a hierarchy. A location can use a later cutoff, never an earlier one. Pause one location without pausing the business, or pause the business while preserving every location's saved schedule.

Your head office can maintain a consistent program across the business while allowing location-specific earning opportunities, rewards, and campaigns. Admins with access to all locations can oversee the program across the network, while location-restricted Admins manage rules and settings for their assigned locations.

For additional control, Admins with access to all locations can **lock a perk's eligible locations**. This prevents location-restricted Admins from removing or otherwise changing the locations assigned to that perk. Any Admin with access to all locations can lock or unlock those location assignments.

Learn more: [Loyalty Program settings](https://docs.perkville.com/features/settings/loyalty-program.md#locking-perk-locations) and [location-specific staff controls](https://docs.perkville.com/features/settings/staff-members.md#location-specific-staff-controls).

## Adding a location to an existing program

When an existing Perkville business opens another location, the setup can involve more than creating the location record. Integration authorization, external location IDs, location-scoped program rules, staff access, location groups, and pre-launch verification may also be required.

Use [Adding a location to an existing program](https://docs.perkville.com/features/settings/location-setup/locations/add-and-configure-a-location.md) as a shareable launch checklist.

## Earning rules by location

Use common earning rules across your locations, or create separate rules for selected locations when activities or incentives differ. For example, you might offer the same check-in incentive throughout the business while rewarding a service available at only certain locations.

When configuring a custom earning rule, choose the activity, the points or instant rewards customers receive, and the locations that offer it. The location selection also determines where the earning rule appears in the customer-facing program. Automated earning requires a connected integration or an integration using Perkville's API.

Learn more: [Earning rules](https://docs.perkville.com/features/earning-rules.md) and [custom earning rules](https://docs.perkville.com/features/earning-rules/custom.md).

## Promotions by location

Run promotions across your business or limit them to selected locations. Each promotion lets you choose the qualifying earning rules and valid earning locations, so you can coordinate a brand-wide campaign or tailor incentives to a particular location, region, or franchise's locations.

* [**Date-range bonus (Promotion)**](https://docs.perkville.com/features/earning-rules/promotions-and-bonus-earnings/promotion-bonus.md)**:** Apply a point multiplier to selected earning rules during a specified date range, such as double points on referrals during a month-long campaign.
* [**Frequency bonus**](https://docs.perkville.com/features/earning-rules/promotions-and-bonus-earnings/frequency-bonus.md)**:** Award bonus points when customers reach an activity target within a week or month, such as attending eight classes in a month. You can also set a one-time goal starting from a selected date.
* [**Time bonus**](https://docs.perkville.com/features/earning-rules/promotions-and-bonus-earnings/time-bonus.md)**:** Apply a point multiplier on selected days of the week and times of day, such as double points for weekday afternoon visits to encourage off-peak activity.
* [**Recurring bonus**](https://docs.perkville.com/features/earning-rules/promotions-and-bonus-earnings/recurring-bonus.md)**:** Reward customers each time they complete an activity a set number of times, such as every tenth visit. The count resets after each bonus, allowing customers to earn it repeatedly.

Create separate promotions when different locations need different incentives, schedules, or goals.

Learn more: [Promotions and bonus earnings](https://docs.perkville.com/features/earning-rules/promotions-and-bonus-earnings.md).

## Rewards by location

Make a reward available across your business or select the locations where it can be redeemed. This lets you combine shared rewards with local rewards for services, products, or experiences available at particular locations.

Where point costs, descriptions, or terms need to differ, create separate rewards and assign each to the appropriate locations. Each reward can have its own redemption instructions and voucher settings.

Learn more: [Custom rewards](https://docs.perkville.com/features/redeeming-rules/custom-rewards.md).

## Challenges by location

Run a challenge across your business or focus it on selected locations. Challenge settings let you choose **which locations' transactions count toward progress**, so activities outside those locations do not contribute to that challenge.

When membership settings are enabled, you can also **restrict participation to members from selected locations**. This is separate from choosing where qualifying activity can occur: one setting determines who can participate, while the other determines which locations' transactions count.

This flexibility supports both shared campaigns and challenges tailored to a local initiative or group of locations.

Learn more: [Creating a challenge](https://docs.perkville.com/features/challenges/creating-a-challenge.md) and [Challenge Settings](https://docs.perkville.com/features/settings/challenges/challenge-settings.md).

## Referral offers by location

Use a shared referral offer across participating locations or create different offers for different locations. For example, one set of locations could offer a free introductory class while another offers a trial pass.

Each offer can have its own title, image, promotion details, fine print, redemption instructions, and participating locations. The referral offer is the incentive for the referred friend; the reward for the existing customer who makes the referral is configured separately through the referral earning activity.

Learn more: [Referral offers](https://docs.perkville.com/features/referrals/configuring-your-referral-program/referral-offer.md) and [configuring your referral program](https://docs.perkville.com/features/referrals/configuring-your-referral-program.md).

## Staff access and franchise visibility

Choose both a **role** and the **locations each staff member can access**. The role determines what the person can do, while their location assignments determine where they can do it.

For franchises, assign each franchise owner and their staff access only to the locations they manage. A franchise owner can have access to several locations, a local team member can be limited to one, and head office staff can retain access across the network.

Staff members only see customers associated with their assigned locations. Actions such as adding points, redeeming points, and managing program rules are limited by both the staff member's role and their assigned locations. Location-restricted Admins cannot edit business-wide **Business Info** or **Branding** settings.

Permissions for the **Employee** and **Front Desk** roles can also be customized within the available defaults. Those role changes apply to everyone with that role, rather than being a separate configuration for each franchise.

Learn more: [Staff members](https://docs.perkville.com/features/settings/staff-members.md) and [role permissions](https://docs.perkville.com/features/settings/staff-members/role-permissions.md).

## Location groups and reporting

Organize locations into **location groups** for reporting, such as a region or franchise ownership group. This helps align reporting with how your business is managed, rather than treating every location as an unrelated site.

Use Perkville's reports to review program activity across locations. For example, the **Points By Location** report shows points earned, spent, and expired, along with transaction counts for each location. Reports can be exported as CSV files for further analysis.

Location groups organize reporting; staff location assignments control access. Configure staff access separately so each franchise team has access only to the locations it manages.

Learn more: [Managing locations and location groups](https://docs.perkville.com/features/settings/location-setup/locations.md), [Reports](https://docs.perkville.com/features/reports.md), and [Points By Location](https://docs.perkville.com/features/reports/points-by-location.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.perkville.com/overview/multi-location-businesses-and-franchises.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
