Layout Designer

Assigning Tickets to Tables and Seats

You can assign tickets one at a time from an element's Detail tab, or many at once with Bulk Assign Tickets. All ticket assignments automatically reflect in the Tickets module.

Per-Table Assignment

1. In the Layout Designer canvas, click the table you wish to configure.
2. Open the Detail tab in the right-hand properties panel.
3. Set the Name and Capacity (1–20 seats). The header shows a live (N / Y Seats) counter.
4. Use the Assigned Tickets multi-select to attach tickets up to the table's capacity. The dropdown is filterable by holder name, ticket type, or email.

Per-Seat Assignment

1. Click an individual seat on the canvas (use the Row Seats tool to draw a row if needed).
2. Open the Detail tab.
3. Pick a ticket from the Assigned Ticket single-select dropdown. Only one ticket can be assigned per seat.

Color Indicators

• Red: Table is full.
• Orange: Table is partially occupied.

Customizing Appearance

The Properties tab (next to Detail) controls how an element looks: background and text colors (with Clear / Transparent / Reset to Black helpers and an Alpha slider), font size, rotation, dimensions, and per-element styling. Apply changes individually or select multiple items and use the multi-select operations panel for bulk edits.

Tools and Elements

The left-side toolbar groups the canvas tools. Each element type has its own Detail tab fields when selected.

Bulk Assign Tickets

The Bulk Assign Tickets dialog is the primary workflow for placing many tickets across many tables in one pass. It picks the best fit by sorting selected tables by available capacity and filling the largest first, while preserving any already-correct assignments.

Steps:

1. Click the green Bulk Assign Tickets button in the toolbar's Actions section. The full-screen Bulk Ticket Assignment dialog opens.
2. On the Select Tickets & Tables tab:
   • The left ticket list is searchable by ticket number, holder name, email, company, or contact. Use Filters for advanced criteria, including a Table Assignment Status dropdown (Unset / Assigned / Not Assigned) to focus on unassigned tickets.
   • The right table list is sorted by table name's numeric suffix and shows current assignments and remaining capacity per table.
   • Multi-select tickets and tables by clicking rows.
3. Watch the Assignment Summary on the right:
   • "N ticket(s) ready to be assigned · M seat(s) will remain available" when the selection fits.
   • A capacity warning "⚠️ Warning: N ticket(s) cannot be assigned (capacity exceeded)" when you select more tickets than the chosen tables can hold.
4. Click View Preview to switch to the Assignment Preview tab and check the per-table breakdown of which tickets land where.
5. If the preview looks right, click Assign Tickets to apply. Use Back to Selection to revise. Cancel closes the dialog without changes.

Multi-Select Operations

Hold Shift or Ctrl/Cmd while clicking, drag a marquee selection, or press Ctrl/Cmd + A to select multiple items. When 2 or more elements are selected, the right-hand panel switches to the multi-select operations panel.

• Naming Pattern — bulk-rename the selected items using a pattern such as Table-{n} → Table-1, Table-2, …. Useful for naming a row of seats (A1, A2, A3) or a grid of tables.
• Capacity — bulk-set capacity on multiple tables at once.
• Multi-align — align the selected items by left, right, center (horizontal), top, middle, or bottom (vertical).
• Multi-rotate — apply a rotation angle to all selected items.
• Multi-tilt — tilt (separate from rotation) for visual layout effects.
• Spacing — horizontal and vertical spacing controls for distributing items evenly.
• Gap (Row Seats only) — precise gap between seats in a row.
• Curve (Row Seats only, −100 to +100) — curve a straight row of seats around an arc.

Floor Plan Upload

Place an image of your venue's actual floor plan on the canvas as a visual reference while laying out tables and seats.

Steps:

1. Click the Upload Floor Plan button in the toolbar.
2. Choose an image (JPG / PNG) or a PDF. The file appears as a backdrop on the canvas.
3. With the floor plan selected, the right-hand panel shows additional controls.

Post-Upload Controls

• Opacity — fade the floor plan so your tables and seats are easier to see on top.
• Size — Width and Height to scale the image to the canvas.
• Position — X and Y to nudge the image into place.
• Rotation — rotate the floor plan if needed.
• Drag Lock — lock the floor plan so you don't accidentally move it while placing tables on top.
• Remove — delete the floor plan from the canvas.

Find Table or Seat

For large layouts, the Find Table or Seat modal lets you jump to any element by name without scrolling around the canvas.

Steps:

1. Click the search button in the toolbar's Actions section. The Find Table or Seat modal opens with focus already in the input.
2. Type a name (or partial name) and press Enter.
3. Click any result to select that element on the canvas and close the modal. Press Escape to close without selecting.

Full Overview

The Full Overview button (eye icon, top-right of the header) opens the Full Layout Overview dialog — a read-only summary of every assignment in your layout, organized into three tabs.

• Tables tab — one card per table with an X / Y occupancy badge. Each guest expands to an Accordion showing Email, Ticket Number, and Custom Notes (key/value list).
• Seats tab — one card per individual seat with an occupancy badge (1 / 1 when assigned, 0 / 1 when empty). Shows Name, Email, Ticket Number, and Custom Notes for the assigned guest.
• Booths tab — one card per booth with a status badge (Assigned when a vendor is set, Available otherwise) and the assigned Vendor name.

A single search bar at the top filters all three tabs at once and shows live counts: "Found: N table(s), M seat(s), K booth(s)". Search matches name, ticket number, email, or vendor.

Assigning Vendors to Booths

Vendors are attached to physical booth locations from the booth's Detail tab. Define your vendors first under Vendor Management so they appear in the dropdown.

Steps:

1. Place a Booth on the canvas using the toolbar tool.
2. Select the booth and open the Detail tab in the right panel.
3. Set the Name and Capacity (1–10).
4. Pick a vendor from the Assigned Vendor dropdown (filterable by vendor name).
5. The booth's badge changes from Available (green) to Occupied (red). The booth also appears in the Full Overview → Booths tab with the assigned vendor's name.

Publishing and Saving

Two header controls handle persistence and visibility — the Save button (rightmost) and the Show Layout toggle.

Save

• Click Save at the top right to persist your layout to the database.
• If you try to navigate away inside the app with unsaved changes, a confirmation appears: "You have unsaved changes. Are you sure you want to leave this page?"
• Closing or refreshing the browser tab with unsaved changes triggers the standard browser warning.

Show Layout (Publish)

• The Show Layout toggle in the header publishes the saved layout to a public viewer at /public-layout-design. Attendees can open this URL without logging in to find their seat.
• Toggle off to unpublish — the public URL becomes inaccessible.
• Only the most recently saved version is published. If you make further edits, click Save again to update what the public sees.

Keyboard Shortcuts

The Layout Designer canvas listens for these shortcuts globally (except while typing in input fields).