Scoreboard

Documentation

Scoreboard turns Shopify POS into a live sales scoreboard for your team. This guide walks you through setup, the daily-use loop, and every feature in detail.

Quick start

  1. Install Scoreboard from the Shopify App Store.
  2. Open the app and run the setup wizard — import locations and set monthly targets. Staff register themselves automatically.
  3. Add the Scoreboard tile to your POS home screen (in POS, tap Add tile, then Scoreboard).
  4. Make a sale. Staff appear on the dashboard automatically the first time the order webhook fires.

Setup wizard

The wizard runs once on first open and is reachable any time from Settings, then Continue setup. It has five steps:

  • Welcome: overview + plan detection.
  • Locations: pick which storefronts to track. Already-imported locations are marked.
  • Staff: staff register automatically the first time they ring up a sale or open the POS tile — no manual add. The Staff page lets you rename placeholders ("Staff #12345") in bulk.
  • POS tile: confirm the Scoreboard tile is on your POS smart grid. Scoreboard detects it automatically once a device pins in or rings up a sale.
  • Targets: set a monthly sales target per location. The cost-based calculator inside the location edit modal can suggest one if you'd like to back into a target from your overheads. Optional default commission % can be applied to every active staff in one go on this same step.

Don't run a commission programme? On the Setup checklist in Settings you can mark the Commission step as Not applicable so it doesn't sit there as a permanent red flag.

Staff

Staff are tracked at Shopify staff member ID + location level. The same person at two locations is two records.

  • Auto-discovery: when an order webhook fires with a cashier ID we don't recognise, Scoreboard creates a placeholder named Staff #<ID> on the matching location.
  • Suggest names: on the Staff page, scan recent orders for cashier-name signals (event log lines like "Mika Dekker processed this order"). High-confidence matches show with evidence (top sale, date) — click Accept.
  • Auto-accept all: apply the highest-confidence suggestion for every placeholder in one shot. You're asked to confirm first.
  • Commission multiplier: per-staff multiplier on commission earnings only. 100 = base; 60 = trainee tier; 130 = senior. Independent of the incentive multiplier so a senior associate can be at 130% commission while still earning incentive bonuses at the base rate.
  • Incentive multiplier: per-staff multiplier on incentive payouts. Same shape as the commission multiplier but applied separately. 0% excludes the staff from incentive payouts entirely.
  • Pay no commission: toggle on the staff edit modal. Sets the staff's strategy to "None" so they earn zero commission while still tracking sales for the leaderboard. Common for managers and owners who are salaried — leave the incentive multiplier at 100% if you still want them to earn incentive bonuses.
  • Per-staff drilldown: click any staff name on the Staff or Analytics pages. You'll land on a dedicated view showing their sales for the period, commission breakdown (base × commission multiplier + broadcast bonus + high-value sale bonus = total), live broadcasts affecting their payout, incentive progress with bars, recent sales, and settled-payout history.
  • Search + sort: the Staff table filters by name or location and sorts by name, location, sales, target, or commission %. Bulk-deactivate selected rows in one shot.

Commissions

Every staff member has a commission strategy plus a percentage rate.

  • None: track sales but pay no commission.
  • Over-target only: percent of every dollar above the staff's target.
  • Full sales after target (Pro+): once the target is hit, commission applies to the full period's sales — a stronger threshold-cliff incentive.
  • Tiered (Pro+): different rates at different progress thresholds. Add brackets like "at 80% of target, pay 5%" and "at 100%, pay 8%".

High-value sale boost (Pro+): on top of the regular commission, sales at or above a threshold pay an extra bonus percentage. Configured under Commissions, in the High-value sale boost section.

Settling payouts: at the end of each period click Settle on each staff (or use Settle all selected for bulk). A PayoutRecord row is written and shown on the Settled payouts log below the table. Download all payouts exports a CSV (PayoutId, settled date, staff, location, period, amount, currency, notes) for your accountant or payroll system.

Incentives

Time-bounded rewards for selling specific products or hitting volume goals. Pick a preset:

  • $ per unit sold: e.g. $5 for every protein bar.
  • % of selected sales: e.g. 10% of revenue from selected products.
  • Flat at unit threshold: e.g. $100 once 20 units sold.
  • Flat at revenue threshold: e.g. $100 once $2,000 sold.

Scope each incentive to all products or specific variants, all locations or specific ones, all staff or specific ones. Progress is computed live as orders come in and shows on the POS tile.

Broadcasts

Push a time-bounded commission boost to selected staff and locations. Live broadcasts appear on every targeted POS tile within seconds.

  • Multiplier: 100 = message-only (no boost), 200 = double commission, 150 = 1.5×.
  • Window: set start and end datetime. Defaults to a one-hour window starting now.
  • Scope: all staff/locations or specific ones.
  • Message: optional cashier-facing line shown on the tile.

The POS tile fires a toast when a broadcast goes live, when one's about to start (15min warning), and when one's about to end (5min warning).

POS tile

The Scoreboard tile lives on the POS home screen. It shows the current cashier's progress, rank in the leaderboard, and any live broadcast.

  • Polls every 20 seconds for state changes; speeds up to 5 seconds when a broadcast is live or about to start.
  • Tap the tile to open a full-screen modal with the leaderboard, active incentives, and pacing.
  • Toasts fire on rank-up, milestone hits (25/50/75/100% of target), incentive unlocks, and broadcast events.

Analytics

The Analytics page is the reporting hub. Top to bottom:

  • Period and comparison pickers (vs previous period, vs same period last year), location filter, staff filter — narrow the entire page to a single store or single staff.
  • Headline KPI tiles with sparklines: Total sales, Orders, Average order value, Top performer.
  • Big Progress to target banner — large percent, 20px progress bar, sales/target totals, forecast line.
  • Hero row: 2/3 daily sales chart with comparison-period overlay + 1/3 sales breakdown sidebar (Gross sales, Discounts, Refunds, Net sales, Orders, Items, Average order).
  • Productivity row: Forecast, Time left, Pending payouts.
  • Sales-quality row: Largest sale, Best day, Refund rate, Discount rate.
  • By hour of day + by day of week bar charts.
  • Revenue by location donut.
  • Locations standings table (Pro+) — rank, location, staff count, sales, target, progress.
  • Top performers table — rank, staff, location, sales, orders, AOV, items/sale, top product, refunds, target, progress. Hover a header (AOV, Items/sale, Refunds) for an explanation.
  • Top products table — rank, product, units, revenue.

CSV export available on Pro and up.

Reports — automated PDF email digests

Scoreboard generates polished PDF reports on a recurring schedule and emails them to your team. Two cadences supported: weekly (every Monday at 9am local time) and monthly (1st of each month at 9am local time). Both run independently — turn on either, both, or neither.

Email delivery uses Shopify Flow's built-in Send internal email action — free, runs on Shopify's email infrastructure, no SMTP setup on our side. Setup is two-step:

  1. Download a workflow template from /app/digest (one for weekly, one for monthly). Each is a pre-built Flow workflow with the right trigger, subject line, and HTML body wired up — you import it and only need to swap the recipient email.
  2. In Shopify admin: Apps, Flow, Import workflow, upload the .flow file. Edit the recipient (replace REPLACE_ME@example.com with your real address). Save, then turn on the workflow.

Once your Flow workflow is on, head back to /app/digest and toggle the schedule for that cadence. The cron then runs your Puppeteer-rendered PDF on schedule, uploads it to storage, and fires the Scoreboard report ready trigger — your Flow workflow picks it up and sends the email with the signed PDF download link embedded.

Test buttons on /app/digest let you fire either cadence on demand to verify the workflow before relying on the schedule. Past PDFs are archived at /app/digest/archive — weekly reports retained for 3 months, monthly for 12 months. Click any row to download the PDF as long as it's within the retention window.

Shopify Flow triggers

Beyond reports, Scoreboard exposes Flow triggers that fire on key events. Wire any of them into Flow workflows for celebrations, alerts, or custom automations:

  • Scoreboard report ready — fires when a weekly or monthly PDF report is generated. Payload includes periodLabel, totalSalesFormatted, top performer/location, the signed PDF download URL, and a digestType field (weekly or monthly) you can filter on with a Condition step.
  • Scoreboard target hit — fires the moment a staff member crosses 100% of their period sales target. Payload includes the staff name, location, target amount, and current sales total. Wire to a Send internal email, post to Slack, mint a gift card via Run Code, or however your team celebrates wins.

Audit log

Every destructive admin action is recorded — settling a payout, changing a target, scheduling a broadcast, archiving a location, etc. View the feed at /app/audit. Filter by action substring (live as you type) or entity type. Each entry shows when, who triggered it, the event, the area of the app, and a summary of what changed.

Plans

  • Free: 1 location, 5 staff. Basic commissions. No incentives or broadcasts.
  • Pro ($49/mo): 5 locations, 15 staff per location. All commission strategies. Up to 5 active incentives. Up to 5 broadcasts/month. Standings + CSV export. 12 months analytics history. High-value sale boost.
  • Scale ($249/mo): 30 locations, up to 50 staff per location. Up to 25 active incentives. Up to 50 broadcasts/month. 36 months analytics history. Priority email support.
  • Enterprise: contact us for unlimited everything plus custom integrations.

FAQ

Do you read customer data? No. Scoreboard never reads or stores customer names, emails, phones, or addresses. Only order totals, line items, and the cashier who made the sale.

What happens to my data on uninstall? We mark your shop as uninstalled immediately and stop processing webhooks. About 48 hours later Shopify sends the redact webhook and we permanently delete your records.

Can I run the app on multiple stores? Yes. Each Shopify shop gets its own isolated record set. Plan and billing are per-shop.

I have a question that's not here. Email info@askmario.co.za — we usually reply within a business day.