Cart Pickup or Delivery Selector Not Displaying
Overview
If the Pickup or Delivery selector is not appearing on the cart page, the most common cause is that the widget is intentionally hidden until the app determines that at least one fulfillment method is available.
The cart selector is initially rendered with display: none. Once the cart loads, the app evaluates the available fulfillment methods and automatically displays the first valid option.
If no valid fulfillment method is found, the selector may remain hidden or appear incomplete.
How the Fulfillment Check Works
When the cart loads, the app runs an internal validation process that:
Retrieves the current cart data from Shopify.
Checks whether Store Pickup is available.
Checks whether Local Delivery is available.
Creates a list of valid fulfillment methods:
Shipping
Store Pickup
Local Delivery
Hides any methods that do not meet the configured requirements.
Displays the selector if at least one valid method exists.
Automatically opens the first available fulfillment method.
If all methods fail validation, the selector may never become visible.
Common Reasons the Selector Does Not Appear
Store Pickup Is Disabled
If Store Pickup is disabled in the app settings, the Pickup option will not be displayed.
Check:
App Settings → Pickup Configuration
Confirm Store Pickup is enabled.
Local Delivery Is Disabled
If Local Delivery is disabled in the app settings, the Delivery option will not be displayed.
Check:
App Settings → Delivery Configuration
Confirm Local Delivery is enabled.
Fulfillment Mode Restrictions
Some stores are configured to support only a single fulfillment method.
Examples:
Pickup Only
Delivery Only
When this configuration is enabled, the unsupported option is intentionally hidden.
Pickup Conditions Are Not Met
Store Pickup can be hidden when the cart does not satisfy configured pickup requirements.
Common conditions include:
Minimum cart value
Maximum cart value
Minimum item quantity
Maximum item quantity
Check: Review Pickup Rules in the app settings.
Delivery Conditions Are Not Met
Local Delivery follows similar validation rules.
Delivery may be hidden when the cart does not satisfy:
Minimum cart value
Maximum cart value
Minimum item quantity
Maximum item quantity
Check: Review Delivery Rules in the app settings.
No Eligible Delivery Locations
If no active delivery locations are available for the current configuration, Local Delivery will not appear as an option.
Check:
Delivery locations are active.
Delivery zones are configured correctly.
The customer's cart qualifies for at least one delivery location.
Products Excluded from Pickup
Some configurations exclude specific products, variants, collections, or tags from pickup eligibility.
If the cart contains a restricted item, Store Pickup may be removed automatically.
Check: Review product and collection exclusion rules.
Shipping Is Also Hidden
If Shipping is not available and both Pickup and Delivery fail validation, there may be no fulfillment method available to display.
In this situation, the selector remains hidden because there is no valid tab to open.
JavaScript or Theme Conflicts
The selector relies on storefront JavaScript to initialize and display correctly.
If the script fails to load or encounters an error, the widget may remain hidden indefinitely.
Check:
Open the browser's Developer Console.
Look for JavaScript errors.
Test using an unmodified theme when possible.
AJAX Cart or Cart Drawer Issues
Many modern Shopify themes dynamically rebuild cart content using AJAX.
When the cart is refreshed, the pickup and delivery widget may need to be reinitialized.
If reinitialization does not occur, the selector may disappear after cart updates.
Common Symptoms:
Selector appears on initial load but disappears after updating the cart.
Selector works on the cart page but not inside a cart drawer.
Support Troubleshooting Checklist
Before escalating to engineering, verify the following:
✅ Store Pickup is enabled
✅ Local Delivery is enabled
✅ At least one pickup or delivery location is active
✅ Pickup rule conditions are configured correctly
✅ Delivery rule conditions are configured correctly
✅ No excluded products or collections are present in the cart
✅ The issue occurs with a simple test product
✅ The issue is reproduced on both the cart page and cart drawer (if applicable)
✅ Browser console has been checked for JavaScript errors
Expected Behavior
When functioning correctly:
The fulfillment selector starts hidden.
The cart is evaluated.
Invalid fulfillment methods are removed.
The first available method is selected automatically.
The selector becomes visible to the customer.
If no method is automatically selected, the selector may remain hidden.
Technical Reference
Cart Widget Template
The selector container is rendered from:
www/resources/snippets/sca.storepickup_cod.liquid
Cart Validation Logic
The fulfillment method validation and auto-selection logic is handled by:
www/resources/assets/js/general_script_cod_cart.js
These references are primarily intended for engineering investigation. Support teams should begin troubleshooting by reviewing app settings, fulfillment rules, active locations, theme compatibility, and browser console errors.