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

# Glossary

> MarketBox's vocabulary, and the words people search for instead.

The rest of this site uses one word per concept, consistently, because a
reader — human or AI agent — needs to know whether two words mean the same
thing or something different. But real people (and agents) search using
whatever word they already know. This page is the landing spot for that:
find the term you typed, and it points you at what MarketBox calls it and
where that's documented.

> [!NOTE]
>
> This page is exempt from the terminology check that runs on the rest of the
> site — it exists specifically to name the words the other pages avoid.

| If you searched for... | MarketBox calls it | What it means | Documented at |
| - | - | - | - |
| provider | **supplier** | The person or resource delivering the service — a stylist, a doctor, a tutor, a meeting room. | [Suppliers](https://docs.gomarketbox.com/resources/suppliers.md) |
| staff, vendor | **supplier** | Same as above — MarketBox uses one word for every shape of "who fulfills the booking." | [Suppliers](https://docs.gomarketbox.com/resources/suppliers.md) |
| customer | **client** | The person the service is for. The dashboard's menu lists clients under **Customers**. | [Clients](https://docs.gomarketbox.com/resources/clients.md) |
| appointment | **booking** | One scheduled unit of service — a supplier, a client, a time window, and one or more service lines. | [Bookings](https://docs.gomarketbox.com/resources/bookings.md) |
| product | **service** | The sellable thing suppliers offer, catalogued per project. | [Services and offerings](https://docs.gomarketbox.com/resources/services.md) |
| option, variant | **offering** | A bookable variant of a service, with its own duration and price. | [Offerings](https://docs.gomarketbox.com/resources/services.md#offerings) |
| bundle, credit pack | **package** | A prepaid set of sessions, drawn down one booking at a time via an order item's `quantityRemaining`. | [Packages](https://docs.gomarketbox.com/resources/packages.md) |
| lock, block | **hold** | A temporary claim on a supplier's time — reserved during checkout, then converted into real bookings or released. | [Holds](https://docs.gomarketbox.com/resources/holds.md) |
| provider portal, staff app | **supplier plane** | The `/suppliers/me` routes a signed-in supplier calls through your portal. | [Build a supplier portal](https://docs.gomarketbox.com/guides/build-a-supplier-portal.md) |
| API scope, permission | **capability** | What kinds of route an API key may call: standard access (`*`) or site events. | [Capabilities](https://docs.gomarketbox.com/concepts/authentication.md#capabilities) |
| analytics, tracking | **site events** | What your site reports about the suppliers it showed, and what clients saw and opened. | [Report site events](https://docs.gomarketbox.com/guides/report-site-events.md) |
| account, workspace, org | **project** | The tenant. Every resource, and every API key's scope, is bounded by one. | [Projects and scope](https://docs.gomarketbox.com/concepts/projects-and-scope.md) |

## Two words that need more than a row

**Session** is not always wrong. When a package funds N individual visits,
each one *is* correctly called a session — "session" is the right word for
the individual bookings a package pays for. It's "session" as a synonym for
a standalone appointment that's wrong; say **booking** for that. See
[Single vs package](https://docs.gomarketbox.com/concepts/booking-engine-model.md#single-vs-package).

**End user** has a specific, narrower meaning: it's the human on the other
end of a Cognito JWT in the end-user auth plane, not a general synonym for
"client." Use it only when you're specifically discussing that auth flow.
See [End-user authentication](https://docs.gomarketbox.com/concepts/end-user-authentication.md).

## Why this page exists

Roughly half of this site's readers are AI agents, not people, and both
kinds of reader arrive typing the word they already know — usually the
generic SaaS word ("customer," "provider," "product") rather than
MarketBox's specific one. Every other page in this site says exactly one
of those words, on purpose: a reader who can't tell whether "provider" and
"supplier" mean the same thing has no way to trust either one. This page
is where the synonym you searched turns into the term you'll see
everywhere else — so you land somewhere useful instead of nowhere.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.