Troubleshooting

If your menu isn’t displaying correctly, don’t worry—most issues can be resolved quickly. Use the steps below to diagnose and fix common problems with ButterMenus.

Possible causes:

  • Plugin Not Active
  • Shortcode Not Added
  • Incorrect Menu ID
  • Toast API credentials not configured

What to check:

  1. Make sure the ButterMenus plugin is installed and active in the WordPress admin panel
  2. Insure that your Toast API credentials are added in settings, and data is flowing on the dashboard.
  3. Confirm your shortcode

    Dinner Menu

    Starters

    Tuna Tartare Tacos
    $18
    Yellowfin tuna, mango salsa, avocado mousse, chipotle aioli, furikake, wonton shell
    • Gluten Free
    • Spicy
    Crispy Chicken Wings
    $15
    Choice of parmesan cowboy butter, harissa honey & cashews, or black truffle buffalo
    • Spicy
    Organic Fries
    $9
    Get ‘em loaded - carne asada, cheese, grilled onions & peppers, chimichurri aioli, black garlic aioli, pickled onion, micro cilantro
    • Gluten Free
    • Add-On

    Salads and Bowls

    Central Coast Cobb
    $21
    Romaine, pickled egg, shrimp, chicken, white cheddar, cucumber, heirloom cherry tomatoes, bacon avocado ranch
    • Vegetarian
    • Gluten Free
    Black Garlic Kale Caesar
    $15
    Local kale, black garlic, anchovy dressing, herb brioche crouton, Parmesan Reggiano

    Handhelds

    Marcerro Burger
    $19
    8oz chuck patty, heirloom tomatoes, chive white cheddar, butter lettuce, red onion, black garlic, fries
    Spicy Fish Tacos
    $15
    Local cod, mango salsa, cabbage slaw, avocado crema, cotija, micro cilantro
    Crispy Chicken Sando
    $18
    Fried chicken, red pepper relish, butter lettuce, pesto aioli, mozzarella, toasted ciabatta, fries
    Beer Brat
    $8
    Guiness bratwurst, peppers/onions, monterey & cheddar cheese, chimichurri aioli, pretzel bun
    Breakfast Burrito
    $16
    Cal Poly sausage & bacon, scrambled eggs, cheese, avocado, home fries, house salsa
    Smokehouse Burger
    $20
    8oz chuck patty, pepperjack cheese, pickled red onion, smokey aioli, black garlic bbq sauce, fries

    Dessert

    Rotating Cheesecake
    $10
    is added to the page where you want the menu to be displayed
  4. Make sure the shortcode is placed inside a Shortcode block or HTML block (not inside a visual-only block).

This usually means ButterMenus is running, but no menu data was returned.

Steps to try:

  • Double-check the Menu ID
  • Make sure the menu exists and is published in Toast
  • Clear the cache:
    • Go to ButterMenus → Dashboard
    • Click Clear Menu Cache
    • Reload the page

Only the PRO version of ButterMenus will display multiple menus, or a specific menu via the shortcode Menu ID.

Free Version:

  • Open plugin settings
  • Check under Display Settings > Select Menu
    • Select the menu you wish to display
  • Clear the cache:
    • Go to ButterMenus → Dashboard
    • Click Clear Menu Cache
    • Reload the page

Paid Version:

  • Check the Menu ID is set for the shortcode
    • [toast_menu id="ID"]
  • Check the plugin Dashboard to ensure the menu data is available / published in Toast
  • Clear the cache:
    • Go to ButterMenus → Dashboard
    • Click Clear Menu Cache
    • Reload the page

ButterMenus caches menu data for performance.

Fix:

  1. Go to ButterMenus → Dashboard
  2. Click Clear Menu Cache
  3. Refresh the page where your menu appears

If changes still don’t appear, verify the update was saved in Toast.

If you’re using the groups parameter, ButterMenus will only show the groups listed.

Example:

[butter_menus groups="GROUP_ID_1,GROUP_ID_2"]

What to check:

  • Confirm Group IDs in ButterMenus → Dashboard
  • Remove the groups parameter temporarily to confirm full menu output

If the Dashboard is empty:

  • Confirm Toast API credentials are entered
  • Verify the Restaurant GUID is correct
  • Ensure API access is enabled in your Toast account

If credentials are wrong, ButterMenus cannot fetch menu data.

This typically means ButterMenus could not authenticate with Toast’s API.

Common causes:

  • Invalid Client ID or Client Secret
  • API access disabled in Toast
  • Incorrect API hostname

What to do:

  • Re-enter your API credentials carefully
  • Save settings
  • Clear the cache and reload the dashboard

ButterMenus includes a default stylesheet, but themes may override styles.

Fixes:

  • Inspect elements using browser dev tools
  • Add custom CSS overrides in your theme
  • Ensure your theme isn’t stripping plugin styles

You can fully control menu styling using standard CSS.

Still Having Trouble?

Contact Support

Purchase a license to unlock all of ButterMenus' great features.

Have a question? We're here for you! Contact us for more info.

Check our documentation library for instructions and tutorials.

ButterMenus is an independent product and is not affiliated with, endorsed by, or sponsored by Toast, Inc.

About

ButterMenus makes it easy for restaurants using Toast POS to show real menus on their WordPress websites. Update your menu in Toast and it updates on your site—no copy-and-paste required.

Privacy Preference Center