Unsupported checkout button
Experiencing issues with MinCart not detecting certain checkout buttons? Here's how to ensure seamless functionality by manually setting a Custom Checkout Selector.
Table of Contents
Overview
MinCart is designed to automatically recognize common checkout buttons. However, it might fail to identify checkout buttons that come from third-party cart drawer apps or unique theme customizations.
The Issue
By default, MinCart is equipped to detect standard checkout buttons. The problem may arise when you have:
- A cart drawer app installed
- A checkout button injected by an app
- A unique checkout button customization
In such scenarios, MinCart might not detect the checkout button.
How to Fix
If you're facing this issue, you can manually specify which checkout button MinCart should recognize. Here's how:
- Navigate to Theme Customization: Open the customization interface for your current theme.
- Locate App Embed: On the left sidebar, you'll see an "App Embed" icon. Click on it.
- Select MinCart Main Script: A list of embedded apps will appear. Select the "MinCart Main Script" embed.
- Set Custom Checkout Selector: You'll find a field named "Custom Checkout Selector". Enter the CSS selector that uniquely identifies your custom checkout button. If you are unsure what to put here, our support will gladly help you with this.
By following these steps, you'll be guiding MinCart to recognize your unique checkout button through the specific CSS selector.
To find the code that uniquely identifies your custom checkout button on a Shopify store, follow these steps:
Method 1: Use Chrome Developer Tools (Inspect Element)
- Open your Shopify store in Google Chrome (or any browser with developer tools).
- Right-click on the custom checkout button and select Inspect.
- In the Elements tab, look for the button’s HTML and class/id attributes.
- Identify a unique selector, such as:
id="custom-checkout-button"
class="custom-checkout-btn"
- A
data-*
attribute likedata-custom="checkout"
- If the button is dynamically generated, look under JavaScript scripts for event listeners.
Method 2: Search in Shopify Theme Code
- In your Shopify Admin, go to Online Store > Themes.
- Click Edit Code for your active theme.
- In the Search bar, look for:
checkout.liquid
(for Shopify Plus stores)
cart.liquid
button
elements intheme.js
orcustom.js
- Use Ctrl + F to search for
checkout
,button
, or specific CSS classes.
Method 3: Check for JavaScript Event Listeners
- Open DevTools (
F12
in Chrome). - Go to Console and enter:
document.querySelectorAll('button')
- Look for any buttons related to checkout.
- You can also check event listeners with:
getEventListeners(document.querySelector('.custom-checkout-btn'))
(Replace .custom-checkout-btn
with the actual class or ID.)
Method 4: Look for App-Injected Elements
If your custom checkout button is added via an app:
- Go to Apps in Shopify Admin.
- Look for any apps that modify the checkout/cart.
- Check Script Tags under Settings > Custom Scripts.
Troubleshooting
If the problem persists:
- Double-check the CSS selector you've entered.
- Reach out to our support for further assistance.
Updated on: 20/03/2025
Thank you!