Core Concepts
Understanding four core concepts will make HummyTummy much easier to use: Tenant, Branch, Roles, and the free core.
Tenant (Restaurant / Business)
A tenant is your entire business as it lives in the system — that is, your restaurant. When you register, a tenant is created for you, and all of your data (menu, tables, orders, staff, reports) is stored under it.
- Each tenant is fully isolated: you cannot see another business’s data, and they cannot see yours.
- Every tenant runs on the free core; once you buy a paid module, your tenant also has a licence term (its anniversary).
- The first user who creates the tenant is always an ADMIN.
Branch
A branch is a physical location under your tenant. At registration, a default branch named “Main” is created automatically — so you have a branch without doing anything.
- Single-location businesses run on one branch.
- The first branch is free. Multi-branch chains add branches by buying the Extra Branch item (annual, with the licence as a prerequisite) per branch.
- A lot of data — menu, tables, orders, stock — is branch-scoped, meaning each branch has its own tables and its own orders.
Behind the scenes, branch-scoped requests carry a branch context
(X-Branch-Id). This is handled automatically when you select your active branch
in the UI — you don’t need to do anything manually in day-to-day use.
Roles
Every user has a role that determines what they can access. There are five roles:
| Role | Who? | Typical permissions |
|---|---|---|
| ADMIN | Owner / top-level admin | Everything: settings, licence/billing and purchases, user management, all branches, reports |
| MANAGER | Branch / operations manager | Operations, menu/tables/staff, reports (on assigned branches) |
| WAITER | Waiter | Take orders from POS, table actions (in their own branch) |
| KITCHEN | Kitchen staff | Kitchen Display (KDS): update order status |
| COURIER | Courier | Delivery / courier flow |
Branch restriction: the WAITER, KITCHEN, and COURIER roles are pinned to a single branch (their own home branch). They can only operate in that branch. ADMIN and MANAGER can switch between branches (ADMIN across all, MANAGER across branches assigned to them).
The first user to register (the business owner) is an ADMIN with access to all branches. You add other staff and assign their roles later from the Admin panel.
The free core
Every newly registered tenant runs on the free core straight away — there is no trial stage:
- Free forever, no charge, no card required, no licence needed.
- What it covers: POS and tabs, kitchen display (KDS), menu management, tables and floor plan, QR menu, order management, cash drawer, basic reports, team and role management, customers, the device and branch panel, custom branding and domain.
- Users, tables, products, categories and monthly orders are unlimited. The first branch is free.
- The account is never locked for “the trial ended” — the free core does not switch off.
Licence and modules
Anything beyond the core is sold as individual annual modules (Advanced Reports & Analytics, Inventory & Cost, Reservations, Staff, AI Menu Studio, API & Webhook, Partner Display API, Priority Support), integrations (Yemeksepeti, Getir, Trendyol Yemek, e-Invoice, Fiscal Printer, Caller-ID, SMS), or capacity (Extra Branch).
- The Maintenance, Support & Updates (annual) is the prerequisite for every paid module: you need it both to buy one and to use it.
- Until you buy a module you pay nothing, and there is no tier to upgrade or downgrade.
The day you buy the licence becomes your account’s fixed anniversary. Every annual item bought later in the year is priced pro rata for the days left until that anniversary, so you stay on one invoice with one renewal date.
For the free core, the licence, and current module prices, see the Licence & Pricing page.