Floor and Table Management

Create floor plans, add and position tables, manage table status (Available, Occupied, Reserved), and generate QR codes so consumers can order at the table.

Common Tasks

How to Create a Floor Plan (New Floor Plan, Add Floor)

Create a floor plan to represent your dining area and place tables on it.

Go to Restaurant → Floor Plan in the left sidebar
Click the + New Floor Plan or Create Floor Plan button
Enter the Name for the floor (e.g. Main Dining, Terrace)
Set Canvas Width and Canvas Height (pixels or units)
Set Grid Size for snapping tables to a grid
Optionally upload a Background Image
Set Sort Order and Is Active
Click Save or Create

Result: The floor plan is created. You can add tables and position them on the canvas.

How to Add and Position Tables (Add Table, New Table)

Add tables to a floor plan and set their position, size, shape, and capacity.

Go to Restaurant → Floor Plan and open the floor plan
Click Add Table or New Table
Enter Table Name and Table Number
Set Min Seats and Max Seats
Set Position X and Position Y (or drag on the canvas)
Set Rotation, Width, and Height
Select Shape: RECTANGLE, SQUARE, CIRCLE, or other supported shapes
Set Status to AVAILABLE, OCCUPIED, or RESERVED
Set Is Active and click Save

Result: The table appears on the floor plan. You can generate a QR code or manage the table access token for consumer ordering.

How to View Floor Status (Table Status, Occupied Tables)

See which tables are available, occupied, or reserved, and view active table sessions.

Go to Restaurant → Floor Plan and open the floor plan
View the floor with tables; status is shown (e.g. color or label: Available, Occupied, Reserved)
Optionally open Floor Plan with Status or a status view to see Elapsed Minutes and Active Table Session (participant count, cart items)

Result: You see table status and, where supported, current order and active consumer session per table.

How to Generate a Table QR Code (Table Access Token, Consumer Ordering)

Generate a QR code for a table so guests can scan and start a table session to order from the Consumer PWA.

Go to Restaurant → Floor Plan and open the floor plan, or open the table
Select the table and use Generate QR, Show QR Code, or Table Access Token
Print or display the QR code at the table

Result: When a guest scans the QR code, they open the Consumer PWA for that table and can start a table session, browse the menu, add items to the cart, and place an order.

Table Session

Consumers scan the table QR to start a table session. Orders from that session are associated with the table. See Consumer PWA for the guest flow.

How to Merge Tables (Combine Tables)

Combine two tables into one for larger parties when your app supports merging.

Open the floor plan and select the table to merge
Use Merge with Table or similar and select the other table
Confirm the merge

Result: The table is linked to the other (e.g. Merged With Table). Orders or status may be shared as per your app behavior.

Key Concepts

Table status: AVAILABLE – no guests; OCCUPIED – in use; RESERVED – reserved for a time.
Table access token: A token tied to the table is used in the QR code URL so the Consumer PWA knows which table the guest is at.
Floor plan with status: A view that includes current order and active table session (participant count, cart items) per table for staff.

For taking orders at the table from staff side, see Restaurant POS and Kitchen (KDS). For guest ordering via QR, see Consumer PWA.

Troubleshooting

QR code scan does not open the right table

Ensure the table has a valid Table Access Token. Regenerate the QR code from the floor plan or table settings so the URL contains the correct token.

Table status not updating

Status may update when a table session starts or an order is assigned. Check that the Restaurant POS or Consumer flow is assigning orders to the correct table.

Cannot add table to floor plan

Ensure the floor plan is Active. Check that position and dimensions are within the canvas size.