Toast issues

For Toast locations connected through StreamOrders

This page covers Toast locations connected through StreamOrders. New Toast locations connect directly to Toast: see Toast. For setup, see Toast through StreamOrders.

Before you start

Have these ready to avoid most problems:

• A Maple location on a plan that includes orders
• Business documents for KYC, which comes after the Toast connection
• Toast login credentials, or the person who holds them available during onboarding
• Management-level access to Toast. If you don’t have it, ask your Toast account owner or administrator; Toast support can tell you who that is
• The Restaurant Management Essentials bundle active in Toast
• Your Toast location’s details, to pick the right one in StreamOrders
• Duplicate or unneeded menus cleaned up in Toast

If you’d rather not work through Toast’s screens, Maple can do the setup for you: grant Maple access to your Toast account and the required POS permissions, and it usually takes about one day. Otherwise your onboarding specialist can walk you through it on a screen share.

Setup finished but nothing happens

All steps are done but nothing syncs. This is usually caching on the Toast side. Don’t troubleshoot each step; remove and re-add the integration, which usually makes it work almost immediately.

1. Open your location’s settings in Maple, go to Integrations, and remove the Toast (StreamOrders) integration. If you can’t, ask Maple support.
2. Reconnect: Orders → Select POS → Toast (via StreamOrders) → Open StreamOrders.
3. Complete the StreamOrders steps again, then click I completed this step in Maple.

Page error on Next at the last step

Clicking the optional Next button after Step 5 (the integration status check) can error. Setup is already complete by then. Reload the page and check the status shows connected.

The Toast step is disabled

Order setup runs in order: Select POS (connect Toast), then Payment Processing (business verification, or KYC), then Enable Orders. Each step stays disabled until the one before is done, and Enable Orders also needs a plan that includes orders.

1. Click Orders in the sidebar and check the Finish setting up Orders card for your current step.
2. Connect Toast first; it doesn’t need KYC. Then finish Payment Processing.
3. If a step stays disabled after the one before is done, contact Maple support.

You can’t find StreamOrders in Toast

Toast needs an active Restaurant Management Essentials subscription for third-party integrations like StreamOrders.

1. In the Toast web portal, go to Browse and Purchase Integrations.
2. Buy the Restaurant Management Essentials bundle.
3. Search for Stream Orders or Partner Connect and continue setup.

If the setup doesn’t work after you buy the bundle, you’re eligible for a refund.

Setup stalls or the menu doesn’t sync

Maple needs certain Toast permissions, including menu builder permissions, to finish setup and sync your menu.

1. In Toast, open the employee or user profile Maple uses.
2. Grant the required permissions, including menu builder access, and save.
3. Retry in Maple, or ask support to confirm the connection.

Toast’s permission numbers may not be what you expect (you might look for “4.5” and find “4.28”), so scroll the full list rather than going by number.

StreamOrders won’t open

If the page is slow, click Open StreamOrders again. Check your browser isn’t blocking pop-ups. If the tab still won’t open, finish the integration directly in the Toast dashboard.

Menus missing, incomplete or duplicated

• The first import from Toast can take several hours. Refresh the Menus page once it’s done.
• Duplicate menus (such as “Takeout” and “Crew Takeout”) cause confusion. Remove internal, crew and test menus in Toast, then resync in StreamOrders (location settings → Integrations → Open StreamOrders).
• If items aren’t recognized in test orders, make item names, descriptions and modifiers in Toast clear and complete.

Undoing published Toast changes

Toast has no version history or undo for published changes. To roll back changes made for Maple (for example modifier groups), change each element back by hand, such as setting required modifiers back to optional and removing added items. Plan changes before publishing.

Contact support