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 — see “This venue has no active menu to sync into”.
  • 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.

”This venue has no active menu to sync into”

The store has no storekit menu yet. This is a storekit condition, not a Toast one — your Toast menu is fine, and there is nothing to check in Toast. Sync Menu imports into an existing storekit menu, so a brand-new store (for example the second, third or fourth site in a group sharing one Toast menu) needs a menu before the first sync. To fix it:
  1. Go to Stores → the new store and click Create a menu.
  2. Choose Enter Manually and click Create a menu. This creates an empty menu on the store; you don’t need to add anything to it.
  3. Connect the store to Toast if it isn’t yet — follow Connecting Toast (Restaurant GUIDConnectEnable Toast POSAlternate Payment Type and Check DiscountSave).
  4. Click Sync Menu under Sync Actions.
Repeat for each store you want to serve the Toast menu — see Using One Toast Menu Across Multiple Stores.

The wrong menu is showing on my store

Sync Menu re-imports the menu Toast Menu is set to; it does not change which Toast menu the store serves. Change Toast Menu under Additional Settings, save, then sync — see Choosing Which Toast Menu Your Store Serves.

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 tips are showing as a service charge (or vice versa)

Check Send Order Tips as Service Charge under Additional Settings. When on, order tips are added to the Service Charge on the check instead of being recorded as a Toast tip; when off, they’re recorded as a tip on the payment. It only affects online orders — pay-at-table tips are always Toast tips.

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.