The Troubleshoot page checks your app settings and lists the ones that hide the pickup and delivery widget or limit when shoppers see it. Use it when the widget is missing from your cart, when one option such as local delivery doesn't show, or when only some shoppers see it. The page only reads your settings. It never changes them.

Find what's hiding the widget

In the app, go to Settings → Troubleshoot.
Read the line at the top. No setting is hiding the widget. means nothing blocks or hides it. Otherwise, the line starts with Start here: and names the most serious finding and how many shoppers it affects.
Work through the findings, starting with the group Blocking the widget. Each one has a title, a short explanation and a link to the setting behind it, such as Open locations.
Click the link, change the setting and save. Then return to Troubleshoot and check that the finding is gone.

What the page shows

Findings are sorted into three groups, most serious first. A group only appears when it has findings.

Group	What it means
Blocking the widget	A setting stops the widget, or an option, from working. Fix these first.
Hiding it for some shoppers	A setting hides the widget or an option for some customers or carts. It may be on purpose, so check that it's what you want.
Rules currently in effect	Settings that limit when an option shows. They work as you set them, so change one only if it isn't what you want.

Each finding has a badge that shows how many shoppers it affects: Affects all shoppers, Affects most shoppers, Affects some carts or Affects few shoppers.

Current setup

Under the findings, the Current setup card summarizes what is turned on. Store pickup and Local delivery show how many of your locations offer them, for example 3/3 locations, or Off. Shipping shows On or Off. The last line says whether the theme app embed is enabled or disabled.

At the bottom, Still stuck? has a Contact support button, and the same button is at the top of the page. It opens a chat with your setup and the page's findings already filled in.

Fix a finding

This table lists the findings under Blocking the widget and Hiding it for some shoppers, with the fix for each. N in a title stands for a number from your store, such as a count of locations.

Finding	What it means	How to fix it
App embed is not enabled in the live theme	The theme app embed loads the widget. While it's off, the widget doesn't show anywhere on your store.	On the app's Dashboard, find App embed, click Enable in theme, then click Save in the theme editor. Use the Dashboard: the link on the finding opens Themes and checkout, which doesn't have this switch.
Store pickup, local delivery and shipping are all disabled	The widget has no option to offer, so it shows nothing.	Go to Settings, open Store pickup, Local delivery or Shipping, and click Enable at the top.
No locations are set up	Store pickup and local delivery need at least one location.	Click Add a location, then Create Location. See Add a pickup or delivery location.
No location has store pickup enabled (the same for local delivery)	The option is on for your store, but no location offers it.	Click Open locations, open each location that should offer it and click Enable in its Store pickup or Local delivery card. See Add and manage pickup and delivery locations.
No store pickup location has an available day or Store pickup has no available day at N locations (the same for local delivery)	Availability is limited to specific days or dates, but none are selected, so every date a shopper tries is rejected.	Open the location and select the days or dates customers can choose. See Choose the days customers can pick up orders and Choose the days customers can receive local delivery.
Store pickup only allows past dates at N locations (the same for local delivery)	Availability is limited to specific calendar dates and all of them are in the past.	Click Open locations and add upcoming dates. See the articles in the row above.
Every store pickup location only serves specific products (the same for local delivery)	Each location offers only some products, and a location is offered only when every item in the cart is one it serves. A cart with any other product sees no location for that option.	Click Open locations and check which products each location offers. See Choose which products a location offers.
Store pickup is enabled but hidden in the widget (the same for local delivery and shipping)	Hide the pickup button in the widget is selected. It hides the button only for carts that don't meet the option's cart contents rule, instead of showing them a message. Other carts still see the button. If no cart contents rule is on, every cart does.	Leave it if that's what you want. To show the button with a message instead, click the link on the finding, such as Open store pickup settings. Select Conditional activation by product type, collection, vendor or tags if it's cleared, because the checkbox only shows while it's selected. Clear Hide the pickup button in the widget, Hide the delivery button in the widget or Hide the shipping button in the widget. If you don't use a cart contents rule, clear the rule checkbox again, then save.
No rate is set up for store pickup (the same for local delivery)	The option is enabled in the widget, but no rate exists for it, so checkout has nothing to show for that choice.	Click Open rates and add a rate. See Set up pickup and delivery rates.
Widget is hidden from guests and untagged customers	Tags are entered in Allow customers with these tags (the finding calls it Only show to customers with these tags), so only logged-in customers with one of those tags see the widget. Guests never do.	Go to Settings → Developers. Under Widget visibility, remove the tags, or tag the customers who should see the widget.
Widget is hidden from some tagged customers	Tags are entered in Exclude customers with these tags (the finding calls it Hide from customers with these tags), so logged-in customers with one of them never see the widget.	Go to Settings → Developers. Under Widget visibility, remove the tag if it's not intended.
Widget is hidden for specific products	The widget disappears when every item in the cart is one of the product handles in Hide widget for specific products. A mixed cart still shows it.	Go to Settings → Developers. Under Widget visibility, remove the handle if it's not intended.
Widget is hidden for all-digital carts	Hide widget when cart contains only digital items is on, so the widget disappears when no item in the cart needs shipping, such as a gift card or a download. A cart with any physical item still shows it.	Go to Settings → Developers. Under Widget visibility, turn the setting off if it's not intended.

These findings appear under Rules currently in effect.

Finding	What it means	Where to change it
Store pickup is limited by a cart threshold (the same for local delivery and shipping)	The option is only offered when the cart total or weight meets the rule you set.	Click the link on the finding, such as Open store pickup settings. See Offer store pickup only for some carts and Offer local delivery only for some carts.
Store pickup is limited by cart contents (the same for local delivery and shipping)	The option is only offered when the items in the cart match the rule you set.	The same as the row above.
N blackout dates configured for store pickup (the same for local delivery)	Those dates are unavailable to shoppers.	See Block pickup on specific dates and Block local delivery on specific dates.
Store pickup is same-day only at N locations (the same for local delivery)	The future-order limit is zero, so shoppers can only choose today.	See Limit how far ahead customers can choose a pickup date and Limit how far ahead customers can choose a delivery date.
Store pickup is limited to specific products at N locations (the same for local delivery)	Those locations are offered only when every item in the cart is one they serve.	See Choose which products a location offers.
Pickup inventory checks are on	Pickup locations are hidden when a stock check shows too few items for the cart.	Click Open inventory settings.
Cart page widget block is not placed in the theme	The widget can appear automatically, but adding the block is more reliable on customized themes.	Click Add the block in the theme editor, then click Save in the theme editor.

Things to know

The page checks the app's settings, locations and rates, and whether the app embed is on in your live theme. It doesn't check your theme's code or your Shopify checkout settings.
Customer tags must match exactly, including capitals. VIP and vip are different tags.
If your store has more than 250 locations, the page says so and skips the checks for each location.

FAQs

The page says "No setting is hiding the widget." but shoppers still don't see it. What now?

The page checks the app's settings and the app embed in your live theme. It can't see these:

A theme you're previewing. App embeds are turned on for each theme separately. Open that theme in the theme editor, turn on Appstle Pickup & Delivery under App embeds and click Save.
A customized cart. If the widget can't find a place on your cart page, add its block: on the Dashboard, find Cart widget, click Enable in theme, then click Save in the theme editor. For a cart drawer, contact support.
Items a location doesn't take. Store pickup hides itself when no location takes every item in the cart, for example a subscription at a location that only accepts one-time purchases. See Let customers choose pickup, delivery or shipping in the cart.

If it still doesn't show, click Contact support under Still stuck?.

Customers see the widget but can't choose a date. Why?

The date picker is off, and the page doesn't check it. For store pickup, open the location, click Show settings in the Store pickup card, and select Enable pickup date picker under Date and time pickers. For local delivery, go to Settings → Local delivery → Checkout experience and select Enable delivery date picker. For shipping, see Set up shipping dates and preparation time.

Why do only some of my customers see the widget?

Check Settings → Developers → Widget visibility. If Allow customers with these tags has tags, only logged-in customers with one of them see the widget, and guests never do. Customers with a tag in Exclude customers with these tags never see it, even if they also have an allowed tag.