Skip to main content
Common Toast integration problems and how to fix them. If you’re still stuck, contact storekit support.

Connection

”Toast POS” isn’t in my Integrations list

The integration isn’t enabled for your account. Contact support to have it turned on.

Connect fails

  • Check the Restaurant GUID is correct for this restaurant — a wrong or mistyped GUID is the usual cause.
  • Confirm your Toast restaurant has online ordering enabled.

I can’t save the settings

When Enable Toast POS is on, Alternate Payment Type and Check Discount are required. Saving fails with “Please fill in all required fields” until both (under Additional Settings) are set.

Nothing imports, or the sync aborts

  • Enable Toast POS must be on and the store must have an active storekit menu before you can Sync Menu.
  • Menu content must be visible to ordering partners in Toast. If everything selected is hidden from ordering partners, storekit aborts the sync (deliberately, so it doesn’t wipe your menu). Make the menu visible to ordering partners in Toast and re-sync.
  • If you’ve set a specific Toast Menu that no longer exists in Toast, the sync aborts — clear or update Toast Menu.

Items show £0

Toast size-based and sequence-based pricing can’t be represented as a single price, so those items import at £0. Set the price in storekit or restructure the item in Toast.

Modifiers are missing

Toast pre-modifier groups are not supported and are skipped. Standard and nested modifier groups import normally.

An item that’s in stock shows as sold out (or vice versa)

Stock follows Toast. storekit snoozes items Toast reports out of stock and restores them when Toast reports them in stock. Re-run Sync Menu to force a reconcile.

Orders

Orders are failing to reach Toast

A failed order is marked failed in storekit with the Toast error message; the customer’s order still completes. Re-dispatch it from the dashboard once the cause is fixed. Common causes:
  • No dining option for the fulfillment method — set the matching dining option (or the Default Dining Option) under Dining Options.
  • An item can’t be matched to a Toast menu group — re-run Sync Menu so items carry their Toast identifiers.
  • Missing Alternate Payment Type — set it under Additional Settings.

Discounts or service charges aren’t on the Toast check

  • Discounts need Check Discount set under Additional Settings.
  • The order service charge needs Service Charge, and delivery fees need Delivery Fee Service Charge.

Order statuses aren’t updating in storekit

Status updates depend on Toast sending guest order status events to storekit, configured during setup. If Preparing/Ready/Complete aren’t flowing through, contact support to check your webhook subscription.

Dine-in & Floor Plan

No tables imported after Sync Floorplan

Tables only import if they belong to a Toast service area. If Toast has no service areas, nothing imports — add service areas in Toast, then Sync Floorplan again.

Dine-in orders aren’t attaching to the right table

A dine-in order only links to a Toast table when storekit has a matching synced table. Re-run Sync Floorplan after adding or renaming tables in Toast.

Pay at Table

A pay-at-table payment failed

  • Alternate Payment Type must be set under Additional Settings.
  • Pay-at-table supports single-check orders only. If staff split the check into multiple checks on the Toast terminal, storekit can’t apply the payment.

Add-to-bill is rejected

Appended orders must be unpaid / cash, single-check, and carry no discounts, service charges, or delivery fees. Card or gift-card orders that have already been charged can’t be added to a check.