Skip to main content
All CollectionsTroubleshooting
Theme troubleshooting
Theme troubleshooting

Check that the widget and theme are working as they should, with common issues and solutions.

Clemency Farmer avatar
Written by Clemency Farmer
Updated over a week ago

When Zapiet - Pickup + Delivery is enabled on your theme, we will automatically:

  • Add the widget in the cart page

  • Add the widget to the mini cart, or redirect the checkout button to the cart page

  • Disable any "Buy it now" buttons

  • Lock the checkout button until your customers fill in the details in our widget

  • Reload the widget when the cart quantity changes

If any of these functionalities do not work, please check below for common causes and fixes.

Widget visibility in cart page

If the widget is not visible in the cart page, you may need to enable the app embed on your theme, or configure your settings.

If Zapiet - Pickup + Delivery cannot locate the checkout button, in your Online store > Theme files > cart file, you can prepend this code to your checkout button:

<div id="storePickupApp"></div> 

You can also add this code in your cart page if you'd like to change the placement of the widget.

For more information, take a look at our Widget not visible on your shopping cart page? article.

Buy it now buttons

The Buy it now button on products pages take customers straight to the checkout page, bypassing the widget on the cart page. If they don't select the details in the widget, the orders will be completed without any attributes from Zapiet - Pickup + Delivery.

Zapiet - Pickup + Delivery automatically disables the buy it now button, but if it is still visible on your theme after enabling the app embed, you can follow our guide to disable the buy it now button.

For more information, take a look at the Dynamic checkout buttons article by Shopify.

Mini carts

There are many types of mini carts across different themes, such as:

  • Mini

  • Modal

  • Ajax

  • Drawer

  • Side

Depending on the theme you're using, the widget can't always be placed in the mini cart.

In this case, we redirect the checkout button in the mini cart to the main cart page. If you are using a theme from the Shopify theme store, it should be done automatically when you enable the Zapiet - Pickup + Delivery widget.

Please note, not all features work reliably in the mini cart. Our conditional activation feature will only reliably work by vendor or product type. If you would like to use conditional activation by tag or collections, you will need to use our app in the regular cart.

If you are using the widget in your mini cart and notice it isn't working correctly, contact us at [email protected] for help.

Locked/unlocked checkout button

If customers can get to checkout without filling in the information within the widget, then your checkout button may be unlocked. This would cause orders to come through without any attributes from Zapiet - Pickup + Delivery.

Alternatively, if customers fill in the widget information but the checkout button is not loading the checkout page, then your checkout button may be locked.

Both scenarios could be caused by using incompatible apps, or scripts that affect the checkout button. Please check if you have any incompatible apps, or if you are using a terms and conditions checkbox, follow our Terms and conditions checkbox support guide.

In an emergency, you can also follow our Zapiet - Pickup + Delivery emergency kit guide.

Refreshing the widget

When your customers change the quantity of items in the cart, the widget also needs to reload. This ensures any product related rules in the widget are followed, such as conditional activation or product specific preparation time.

If your theme automatically updates the cart total when quantity is changed, we will ensure the widget reloads as well. If your theme cart page has an "update cart" button, your customers will need to click it to reload the whole cart page.

If this is not working as expected, contact us at [email protected] for more information.

Did this answer your question?