Why is my Shopify checkout not working?

If customers tell you they cannot complete an order, or you notice that sales have suddenly stopped, the checkout is one of the first things to look at.

A "checkout not working" problem can take many forms:

• the cart button does nothing
• the cart page loads but the checkout never opens
• the checkout opens but shows an error
• shipping rates do not appear, so the customer cannot continue
• a discount code is refused or produces the wrong total
• the payment step fails or loops back to the cart
• the problem only happens in some countries, currencies or devices

Because Shopify is a hosted platform, the checkout itself runs on Shopify's infrastructure. That is reassuring: in most cases the core checkout is working, and the problem comes from something connected to it, such as a setting, an app, the theme's cart code or a shipping or discount rule.

The important thing is to find out where the customer journey breaks before changing anything. Changing several settings at once can hide the real cause and create new problems.

This guide explains what may be happening, which checks are safe to do in the Shopify admin, how to place a test order and when it makes sense to ask for help.

What does it mean when the Shopify checkout is not working?

A Shopify purchase goes through several steps, and each one depends on different parts of your store:

• the product page and the "add to cart" button, controlled by your theme
• the cart, controlled by your theme and sometimes by apps
• the checkout, run by Shopify but influenced by your settings, apps and checkout customizations
• shipping, taxes and discounts, calculated from the rules you have configured
• payment, handled by Shopify Payments or another payment provider

When people say the checkout "is not working", the fault can be in any of these steps. A broken "add to cart" button and a declined payment are very different problems, even if the result is the same: no order.

So the first job is not to fix anything. It is to work out at which step customers get stuck.

What are the most common causes?

Payment settings or the payment provider

If customers reach the payment step but cannot pay, the problem may be with your payment settings or your payment provider account. For example, a provider may need extra verification, or a gateway may have been disconnected.

Payment problems are common enough to deserve their own guide: see why payments are not working on your Shopify store.

An app that changes the cart or checkout

Many apps interact with the buying process. Typical examples:

• upsell and cross-sell apps
• cart drawers and sticky "add to cart" bars
• subscription apps
• product options and personalization apps
• bundle and volume discount apps
• delivery date, gift wrapping or note apps
• currency converters and translation apps

An app update, a new app or a change in an app's settings can interfere with the cart or the checkout. Two apps that both try to change the cart can also conflict with each other.

The theme's cart code

The cart is part of your theme. If the theme was edited, updated or replaced, the cart template, the "add to cart" form or a cart drawer may have stopped working correctly.

This is especially likely if:

• someone recently edited the theme code
• a new theme or theme version was published
• an app added code to the theme and was later removed

Discount rules

Discounts can block a checkout in less obvious ways. A discount may:

• have expired or not started yet
• apply only to certain products, collections or customers
• conflict with another discount
• have usage limits that were reached
• combine with other discounts in a way you did not expect

Automatic discounts and apps that create discounts can also change totals without customers entering any code.

Shipping rules

If no shipping rate matches the customer's address, cart weight or cart value, the customer may not be able to continue. This often happens when:

• a new country or region was added to the store without shipping rates
• product weights are missing or wrong
• rates depend on price or weight ranges that leave gaps
• a shipping or delivery app stopped returning rates
• local pickup or local delivery settings were changed

Markets, currencies and countries

If you sell internationally, Shopify Markets settings decide which countries you sell to, which currency customers see and sometimes which payment methods are available.

A problem may appear only for customers in one country or paying in one currency. That is a strong clue that the cause is in your market, currency, shipping or payment configuration rather than in the checkout as a whole.

Checkout customizations and extensibility changes

Shopify has been changing how stores can customize the checkout over time, moving towards newer, app-based ways of extending it. Older customizations may stop being supported or may need to be rebuilt.

If your store has custom checkout code, checkout scripts or checkout apps that were set up some time ago, it is worth checking whether Shopify has sent you notices about them. Look in your admin notifications and in the emails sent to the store owner. A developer can review what is still supported for your plan and setup.

First, find out where the journey breaks

You can do this yourself in a few minutes.

Open your store in a private or incognito browser window and try a purchase the way a customer would:

1. Open a product page.
2. Add the product to the cart.
3. Open the cart.
4. Start the checkout.
5. Enter a real-looking address.
6. Check whether shipping rates appear.
7. Check whether the total is correct.
8. Stop before paying, unless you are using a test payment method (see the hands-on section).

Write down exactly where it fails and what you see. A screenshot of any error message is very useful.

Then try to answer:

• Does it fail on every product or only some?
• Does it fail on mobile and desktop?
• Does it fail with a different shipping address or country?
• Does it fail with and without a discount code?
• When did customers start reporting it?
• What changed around that time: an app, a theme edit, a new shipping rule, a new market?

A note such as "the checkout stopped showing shipping rates for Germany after we added a new market on Monday" can save a lot of investigation time.

Check what Shopify itself is telling you

Before looking for a complex cause, check the simple ones:

• Admin notifications and emails: Shopify may have sent a message about your payment provider, account verification, billing or checkout changes.
• The Shopify status page: search for Shopify's official status page to see whether Shopify is reporting a problem with the checkout or payments. If it is, the best action is usually to wait and monitor.
• Recent orders: in Orders, check when the last successful order arrived. This tells you roughly when the problem started.
• Abandoned checkouts: if customers are reaching the checkout but not completing it, the abandoned checkouts list can show where they stopped.

What can you safely try?

Review the most recent change

If an app was installed or updated, a theme was edited or published, or a shipping, discount or market setting was changed shortly before the problem started, that change is your first suspect.

If someone else made the change, such as a developer, agency or colleague, ask them what exactly they did.

Check your shipping settings

In Settings → Shipping and delivery, check that:

• the countries or regions where customers are failing have shipping rates
• rate conditions based on weight or price do not leave gaps
• the products involved require shipping and have a sensible weight

Then try the checkout again with an address in the affected area.

Check the discount involved

If the problem is linked to a discount, open Discounts and check its dates, eligibility, minimum requirements, usage limits and combination settings.

Try the checkout without the discount. If it works, you have narrowed the problem down.

Check your payment settings

In Settings → Payments, check whether there are warnings, verification requests or a disconnected provider. If you see a message asking for action, follow it or contact the provider. Do not change several providers at once.

Test the checkout without a suspicious app

If you strongly suspect a specific app, check its settings first. Many apps have an option to disable a feature or turn off their storefront component without uninstalling.

Be careful with uninstalling: some apps leave code behind in the theme, and uninstalling may delete the app's data or settings. If the app handles subscriptions, bundles or product options, uninstalling it can affect existing customers and orders.

Preview the previous theme

If the problem started after a theme change, you can preview an older theme from your theme library and test the cart there. Previewing does not affect what customers see. See what to do if your Shopify theme broke after an update for more on this.

What should you avoid doing?

When sales stop, it is natural to try everything quickly. Some actions can make things worse:

• uninstalling several apps at once
• deleting shipping profiles or discounts without noting their settings
• switching payment providers in a hurry
• editing the live theme's code directly without a duplicate
• publishing an old theme without checking what it is missing
• copying code from forums into the theme
• placing real orders with real cards to "test" repeatedly

Change one thing at a time, test, and keep a short record of what you did.

When should you ask for technical support?

It is a good idea to ask for help when:

• no customer can complete an order and you cannot see why
• the problem involves custom theme code or a cart drawer
• several apps touch the cart or checkout and you suspect a conflict
• the issue affects subscriptions, bundles or product options
• the problem only appears in some markets or currencies
• your store uses older checkout customizations
• Shopify or an app developer says the problem is "in your theme" or "in another app"
• you have already tried a few things and are no longer sure what changed

You do not need to diagnose the problem yourself before asking for support.

What information should you collect?

Useful details include:

• your store URL
• the step where the checkout fails
• screenshots of any error message
• when the problem started and when the last successful order was placed
• the devices, browsers and countries affected
• recent changes to apps, theme, shipping, discounts or markets
• the payment providers you use
• any messages from Shopify, an app or a payment provider

Do not send passwords by email. If someone needs access to your store, add them as a staff member or collaborator from the Shopify admin, with only the permissions they need.

How D4Hub can help

D4Hub can help with:

• reproducing the problem and finding the step where the checkout breaks
• reviewing recent app, theme and settings changes
• checking the theme's cart code and cart drawer
• identifying conflicts between apps that modify the cart or checkout
• reviewing shipping, discount and market configuration
• checking older checkout customizations against what Shopify currently supports
• coordinating with app developers and payment providers
• running test orders and checking the full buying process after the fix

You can ask for support at any stage, whether you need a quick second opinion on a setting or want someone to take over the whole investigation.