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
The Issue
How to Fix
Troubleshooting

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:

Tip: When you see class, then the custom selector should be: ".satcb-cs-checkout-btn", class becomes a dot.
If it was id="satcb-cs-checkout-btn", then the selector would have been "#satcb-cs-checkout-btn", id becomes an hashtag.

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 like data-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 in theme.js or custom.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