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 are set in Orders → Edit. After changing a setting, click Save in the bar at the top of the page.Menu Sync
Nothing imports, or the sync aborts
- Enable Toast POS must be on and saved before you can Sync menu from the page header. If the store has menus but none of them is active, 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 any menu selected in Toast Menus no longer exists in Toast, or is hidden from ordering partners, the whole sync aborts — remove that menu from Menu → Edit → Toast Menus, click Save in the top bar, and re-sync.
”This venue has no active menu to sync into”
The store has a storekit menu, but it is marked Inactive on Menus. This is a storekit condition, not a Toast one — your Toast menu is fine, and there is nothing to check in Toast. A store with no menus at all doesn’t hit this: the first Sync menu creates a menu for it. storekit won’t create a second menu next to an inactive one, so to fix it:- Go to Menus, click Edit on the inactive menu, click Settings and click the Archive Menu button. See Archiving and un-archiving a menu.
- Click Sync menu in the page header. storekit creates a new menu and imports your Toast menus into it.
The wrong menu is showing on my store
Sync menu re-imports the menus Toast Menus is set to; it does not change which Toast menus the store serves. Change Toast Menus under Menu → Edit, click Save in the top bar, then sync — see Choosing Which Toast Menu Your Store Serves.Menu names show as empty headings, or categories appear twice
The store is importing several Toast menus with Import each Toast menu as a category on, but subcategory navigation isn’t enabled on the store. Turn Import each Toast menu as a category off under Menu → Edit, click Save in the top bar and then Sync menu in the page header — your Toast groups become the top-level categories again. See Showing Each Toast Menu as a Category.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 marks items Toast reports out of stock as unavailable and restores them when Toast reports them in stock. Re-run Sync menu to force a reconcile.An item I made unavailable in storekit is orderable again after publishing in Toast
Expected. A Toast publish triggers a menu sync, and every sync resets the storekit Available toggle and Track Inventory state to what Toast reports. Mark the item out of stock in Toast instead; only a timed snooze and Available After survive a sync. See Stock & Availability.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) in Orders → Edit.
- 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 in Orders → Edit.
Discounts or service charges aren’t on the Toast check
- Discounts need Check discount set in Orders → Edit.
- 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 in Charges & tips → Edit. 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 syncing the floor plan
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 click More → Sync floor plan 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 More → Sync floor plan after adding or renaming tables in Toast.Pay at Table
A pay-at-table payment failed
- Alternate payment type must be set in Orders → Edit.
- 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.