When the Menu Updates
storekit imports the menu when Stream sends a publish event for the location. The import runs in the background: storekit downloads the published menu file, uploads any new images, then rewrites the store’s menu to match. Publishing again while an import for the same menu is still running is skipped, so wait for the first import to finish (a lock is held for up to 30 minutes) before re-publishing.Requesting a Re-Publish
If the storekit menu looks out of date, click Sync menu in the Connected to Stream row under the menu header, or Refresh menu on the store’s Stream settings page. Both ask Stream to re-publish the location’s latest menu — the dashboard confirms with Menu refresh requested and Stream will re-publish the latest menu shortly. The import itself still runs when Stream publishes, so allow a few minutes.Sync menu doesn’t pull the menu into storekit itself; it only asks Stream to publish. See POS Menu Sync for how this compares with other providers.
What Gets Imported
Each Stream menu becomes one storekit menu on the store, matched by its Stream ID. The first publish creates the menu (named after the Stream menu); later publishes update it and its name.
Images are copied into storekit’s image storage on import, so they keep working if the Stream URL changes.
Nutrition
storekit imports calories in kcal from each Stream item. When a product has several variations, each variation keeps its own calorie value. Modifier options can also carry calories. For items, storekit imports these macronutrients fromadditional_nutritional_details when Stream supplies a numeric value in grams (g) for each one:
Values in other units, such as milligrams (
mg) or ounces (oz), aren’t converted to grams. Unsupported nutrients aren’t shown in the macronutrient breakdown. If a later publish includes some nutrients but omits others, the previously imported values for those omitted nutrients can remain. Publish the corrected values rather than relying on omission to remove them.
Stream documents macronutrients on its items (variations of an item family), but only documents calories on modifiers. storekit also imports gram-based macronutrients from modifier options if Stream supplies them; don’t assume a modifier has those values unless they are present in the published menu.
Stream Overwrites the storekit Menu
Every publish rewrites the menu from Stream:- Names, descriptions, prices, images, availability and translations are replaced with Stream’s values. Allergen, dietary and alcohol tags are rebuilt from Stream; other tags you added in storekit are kept.
- Categories, items, variations and modifier groups that are no longer in the published menu are deleted from the storekit menu.
- Because the menu is POS-managed, categories and items can’t be added in the storekit menu editor — trying to add one opens Add categories in Stream (or Add products in Stream), which explains they need to be created there. Make menu changes in Stream and publish.
Limitations
- No subcategories — Stream categories import as a flat list.
- No scheduled sync from storekit; publishing in Stream is the only trigger. Sync menu and Refresh menu ask Stream to publish again.
- Import happens per menu. If a location publishes several menus, each is imported in turn, and each is locked separately.
- Items missing from the published file are skipped, and any Stream IDs storekit can’t match are logged rather than failing the import — check the storekit menu after publishing if something looks absent.
Next Steps
Stock & Availability
Availability and stock changes between publishes
Orders
How imported items and modifiers appear on orders sent to Stream