Stream Troubleshooting

Common Stream problems and how to fix them. If you’re still stuck, contact storekit support.

​

Connection

​

”Stream” isn’t on my Integrations page

Stream is connected from Stream, not from the storekit dashboard — see Connecting Stream. Its Stream settings page is only listed for stores that don’t take dine-in orders, and it needs a storekit+ subscription. If you can’t see it, ask support for any storekit-side settings.

​

My store isn’t offered when connecting the location in Stream

Stream only lists the stores you granted on the consent screen:

• If you turned off Access all available venues and picked stores, the missing store wasn’t selected. Reconnect from Stream and include it.
• If Access all available venues was on, your storekit login can’t see that store. Ask an account owner to grant your user access to it (or connect with a login that has it), then reconnect.

Stream identifies each store by its name and address, so make sure the address is saved on Stores → your store → Settings → General before connecting.

​

I connected the wrong storekit store

Disconnect the location in Stream — this clears the store’s POS provider in storekit — then connect the right one. Orders placed on the wrongly connected store in the meantime were sent to Stream.

​

Orders stopped going to Stream after I connected another POS

A store has one POS provider. Connecting a different POS integration to the store replaces Stream; connecting the location again in Stream sets it back.

​

Menu Sync

​

I published in Stream but storekit hasn’t changed

• The import runs in the background after Stream notifies storekit — allow a few minutes.
• If another import for the same menu was still running when you published, the new publish was skipped. Publish again once the first import has finished (the lock lasts up to 30 minutes).
• Check that the store you published for is the one connected in Stream.
• If it still hasn’t updated, click Sync menu in the Connected to Stream row under the menu header to ask Stream to re-publish.

​

Sync menu didn’t change anything

For Stream, Sync menu (and Refresh menu on the settings page) only asks Stream to publish the menu again; storekit can’t pull it. If nothing changes after a few minutes, check the location is publishing in Stream.

​

I can’t add a category or item in storekit

The menu is managed by Stream — adding one opens Add categories in Stream (or Add products in Stream). Add it in Stream and publish.

​

An item or modifier is missing after a publish

• The item, or a modifier it uses, wasn’t in the published file for that menu. Check it’s assigned to a category on that Stream menu and published.
• Items removed from the Stream menu are deleted from the storekit menu on the next publish, so a missing item is usually one that was removed in Stream.

​

Item prices are wrong for one menu

Stream menu-specific price overrides are applied only when active for that menu. Check the override in Stream and publish again.

​

Calories show, but the macronutrients show 0g

Calories and macronutrients are separate values in the Stream menu. Check that the published Stream item has macronutrient values in grams (g), not just calories. If the product has several variations, check the variation you’re viewing. storekit imports carbohydrates, fat, fibre, protein, salt, saturated fat and sugars when Stream supplies them as numbers in grams; other units aren’t converted. Publish the menu again in Stream, then allow a few minutes for the import. If the values still show as 0g, contact storekit support with the store, item name and time of the latest publish so they can check what was sent and imported. See Stream Menu Sync → Nutrition for the supported fields and modifier limitations.

​

Allergens are missing on some items

storekit maps Stream’s allergen codes to its own allergen tags; codes it doesn’t recognise are skipped. Ask support which codes aren’t mapped.

​

Orders

​

Orders aren’t reaching Stream

• Check the store is connected to Stream, not another POS — see Connection above.
• If Buffer orders is on, pre-orders are held until Buffer value minutes before the fulfilment time (or the store’s prep-time-based release). Check the order’s requested time before assuming it’s stuck.
• An order that failed before Stream accepted it shows Failed with no failure reason — Stream refused the request. Open the order and click More actions → Resend order to POS to try again.

​

An order is Failed with a reason from Stream

Stream accepted the request, but the POS failed the order and Stream reported why. The reason is stored against the order word for word and emailed to the store. Because Stream has already accepted the order, Resend order to POS is refused for it (see below) — fix the cause at the POS (for example an item that no longer exists there) and key the order in there by hand.

​

Resend order to POS says the order was already sent

This order has already been sent to the POS. Resending it would create a duplicate POS order. means Stream has already accepted the order, including orders the POS later failed. Look for it at the POS rather than resending.

​

I’m not getting failed-order emails

The email is sent only when Stream reports a failure (not when Stream refuses the request), and goes to the addresses in Email address on Stores → your store → Settings → General — the first as recipient, the rest as blind copies. If that list is empty, no email is sent. The address you log in with receives nothing unless it’s in that list.

​

The order is on the ticket under a placeholder name or phone

Orders placed without a name are sent with Placeholder as the name, and orders without a phone number with +447700900000, so the POS always has a contact. Turn on the relevant checkout fields in storekit if you need real values at the POS.

​

The order reached the POS but the table is wrong

storekit sends the table’s number (or its name when no number is set), not its POS ID. Check the table on Stores → your store → Settings → Tables — see Dine-in.

​

Customers weren’t told the order was ready or completed

Status updates from Stream change the order’s status but don’t send the customer notifications a manual status change sends. Once Stream has moved the order on, you can’t select that status again in storekit to trigger the notification, so contact the customer directly if they need to know. storekit only acts on ready_for_pickup, out_for_delivery and completed; other Stream statuses are ignored.

​

Stock & Availability

​

Sold-out items are still orderable

• Availability updates are matched on the item’s Stream ID. If the item was replaced in Stream (a new ID), publish the menu so storekit has the new item.
• Stock counts are applied only while Sync inventory is on. Check it on the Stream settings page.
• An item family turned back on in Stream doesn’t re-enable its variations — each variation is re-enabled individually as Stream reports it.

​

Items I made unavailable in storekit came back

Stream is the source of availability for the menu. Turn the item off in Stream instead.

​

The store is Offline or snoozed and I didn’t do it

Stream paused the location — see Pausing the Store From Stream. A pause with an end time shows Reopens … on Stores and lifts itself; a pause without one leaves the store Offline until Stream resumes the location. Resume it in Stream, or turn the store back on in storekit.

​

Related Pages