Toast POS Shift Summary Badge

WHAT IT DOES

This userscript transforms your Toast POS shift summary page into a clear, actionable dashboard. It extracts all key shift metrics—gross sales, net sales, tips, order count, average ticket, payment method breakdown, and labor cost—and displays them in a sticky summary badge at the top of the page. The badge stays visible as you scroll, keeping your shift performance metrics always in view. Beyond the badge, the script provides a detailed breakdown panel with a full report that you can copy to your clipboard with one click. The report includes all metrics in a clean, readable format suitable for bookkeeping, manager reporting, or end-of-shift reconciliation. You can also enable auto-copy to have the report automatically copied to your clipboard whenever you load the shift summary page, saving time for busy restaurant managers and staff.

WHERE IT RUNS

The script runs on all Toast POS web application pages at *.toasttab.com/*, with automatic detection of shift summary pages including the end-of-shift summary, shift reports, and any page displaying shift data. It works across all Toast interfaces by using multiple selector strategies to find sales totals, order counts, tip data, labor costs, and payment method breakdowns. The script detects dynamic content loading and re-applies the badge whenever the shift data changes. It runs across the entire Toast domain, ensuring coverage whether you're reviewing a completed shift or monitoring a live shift in progress.

HOW TO USE

Install the script via the BotGentz extension and navigate to any shift summary page in Toast POS. A sticky badge will appear at the top of the page showing your key metrics—total sales, order count, average ticket, tips, labor cost percentage, shift duration, and employee name. The badge stays fixed as you scroll, so you always have your numbers visible. Use the panel controls to customize your experience: toggle the badge on or off, enable auto-copy to automatically copy the full report to your clipboard on page load, and choose whether to include tips or labor cost in the report. Click "Copy full report" to copy a complete, formatted report to your clipboard for pasting into spreadsheets, email, or accounting software. Click "Refresh shift data" to manually re-scan the page for updated metrics. The panel also includes a preview of the full report so you can review the data before copying.

THE MECHANISM - DATA EXTRACTION AND VISUAL SUMMARIZATION

This script extracts shift data by scanning the DOM for known Toast POS elements. It uses a cascading selector strategy that looks for specific data-test attributes, common class names (.gross-sales, .net-sales, .tips, .order-count, .labor-cost), and structural elements. For each metric, the script applies multiple fallback selectors to handle different Toast interface versions. Amounts are parsed by stripping currency symbols and non-numeric characters, ensuring accurate financial calculations. Payment methods are extracted from payment breakdown sections and aggregated with amounts. Shift times are parsed from date strings and used to calculate duration. The summary badge is created as a sticky DOM element positioned at the top of the page using position:sticky, ensuring it remains visible during scroll. The report generation formats all extracted data into a structured text report with clear sections. Auto-copy uses GM_setClipboard to place the report on the system clipboard without user interaction.

THE PANEL

The control panel appears as a floating, draggable element that you can position anywhere on the Toast page. Drag by the header to reposition it, and the position is saved per site using GM_setValue so it stays where you left it across sessions. Release the panel near any edge and it snaps into place, keeping your workspace organized. Click the panel header to collapse it into a small bubble showing only the chart emoji (📊), minimizing distraction while keeping controls accessible. Drag from the bubble to restore the full panel. The panel automatically resizes to fit its content and includes all setting toggles and action buttons. Press the Escape key to quickly collapse the panel to its minimized state. The panel remains visible across page navigation within Toast, with the badge updating automatically as you move between shift views.

PLEASE NOTE

This script requires the free BotGentz extension to function. It is designed for Toast POS users who need quick access to shift metrics for reconciliation, reporting, or end-of-shift procedures. The script reads only visible shift data from the DOM—it does not access Toast's API, your account credentials, or any sensitive information. All settings (badge visibility, auto-copy, and report preferences) are stored locally using GM_setValue and never leave your browser. The script does not modify your Toast data—it only reads and displays visible information. The metrics displayed are based on the data currently visible on the page; if Toast updates its website structure, the script may need to be updated to match new selectors. The auto-copy feature requires clipboard permissions granted through the BotGentz extension.