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

# Designing your plans

> Every field on a WiFi plan, what it does to the customer, and the one rule that surprises people.

A plan is what a guest buys on your captive portal. You need at least one before a gateway is any use.

Go to **Plans → Create plan**.

## The fields

| Field                                  | What it does                                                                                                        |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Name**                               | What the guest sees on the portal. Make it describe the deal — *Day Pass · 24h · 5 GB* reads better than *Plan A*.  |
| **Sold at**                            | Which location sells this plan. **Every site** offers it everywhere; picking one location hides it from the others. |
| **Price**                              | What the guest pays. Enter `0` for a free plan.                                                                     |
| **Duration**                           | How long access lasts from the moment of purchase, in hours or days.                                                |
| **Data limit (GB)**                    | Total data allowed. **Leave blank for unlimited.**                                                                  |
| **Devices**                            | How many devices may be attached to one purchase.                                                                   |
| **Download / Upload speed (Mbps)**     | The speed cap while the plan is running. Leave blank for no cap.                                                    |
| **Throttle after (GB)**                | Fair use. Past this much data the speed drops instead of access being cut.                                          |
| **Throttled download / upload (Mbps)** | The reduced speed after the throttle point.                                                                         |

Use the toggle on a plan card to take a plan off sale without deleting it. Deleting is refused for a plan anyone has ever bought, because that would take their purchase history with it.

<Note>
  Data is counted in decimal units throughout WifiPadi: 1 GB is 1,000,000,000 bytes. A 5 GB plan delivers five billion bytes, and both upload and download count towards the limit.
</Note>

## Two plans, one name

A plan name must be unique within its scope. **Every site** is one scope and each location is another.

This is what lets you sell *Day Pass* at ₦200 in one branch and ₦350 in another: create it twice, once per location, and leave the shared version off. The dropdown greys out any scope that already sells that name, so you find out before you save rather than after.

## Data limits and device limits together

A data limit is **one shared allowance**, not one per device. Some gateways can meter that allowance across several devices at once and some cannot, so on a capped plan the number of devices that actually run at the same time depends on your hardware.

You do not have to work out which is which. **If you set a data limit and more than one device, the plan form tells you** — by name — which of your gateways would run that plan one device at a time, and what to do about it.

<Note>
  If you see that warning, your options are: remove the data limit, set **Devices** to 1, or — on a Nano Pi that simply has not reported what it can do yet — run **Agent update** from its gateway page. See [Looking after a gateway](/gateway-care#remote-actions).
</Note>

Customers on a capped plan can move their access between their own devices themselves, from the portal. The device they choose stays chosen rather than being taken back by whichever one checks in next.

## Speed limits and fair use

The two are different tools.

* **Download / Upload speed** is a hard ceiling for the whole plan. Use it to keep a cheap plan cheap.
* **Throttle after** is a soft floor. The plan keeps working past that point, just slower.

Fair use is what makes an unlimited plan safe to sell. Leave **Data limit** blank so it never cuts off, and set **Throttle after** so one guest streaming all day cannot flatten the line for everyone else.

## Free plans

Set **Price** to `0`. The guest still signs up and still gets a duration, a data limit and a device count — they simply are not charged. Useful for a hotel that includes an hour with the room, or for testing your portal end to end before you open.

## Testing a plan

Create your cheapest plan, connect a phone to the WiFi, and buy it. Then check:

* Access is granted within seconds of paying — if it takes minutes, see [Connect the webhook](/payment-providers#connect-the-webhook).
* The plan appears under **Payments** as **Successful**.
* **Sessions** shows the phone as live.
* The speed matches what you set.