Shopify Knowledge Base

Fix common Shopify problems.

Search the symptom you are seeing (checkout, shipping, discounts, filters, theme, markets or admin) and get the likely causes and what to check first, before it turns into dev work.

Showing 23 of 23 issues

Cluster

Black Friday and Peak Season Issues

Problems that stay hidden at normal traffic and surface when a promotion, a traffic spike and a tired team all arrive in the same week. Start with the hub guide, then go to the specific fix.

Shopify Black Friday problems: the ones that break stores, and the fixes

Issue

Traffic peaks and something that worked all year stops working: codes refuse to combine, some addresses get no shipping rate, product pages drag, stock oversells, or the inbox fills with where-is-my-order emails.

Likely causes

  • Promotions built from several discounts whose combination settings were never tested together.
  • Price-based or weight-based shipping rates that stop matching once a discount changes the cart.
  • App and theme scripts that were tolerable at normal traffic running on every product page view.
  • Inventory, fraud and support setups that assume a slow, steady order rate.

What to check first

  • 01Build the cart combinations your campaign will actually create and take each one through a new checkout.
  • 02Test checkout with an address from every market you sell to, after the discount is applied.
  • 03Freeze theme and app changes before the sale and write down exactly what is installed.
  • 04Decide who answers order-status questions, and what they can see, before the emails start.

When to escalate

Escalate when a failure spans discounts, shipping and markets at once, or when the store runs custom Functions, checkout extensions or an inventory sync that nobody on the team can test end to end before the sale.

Shopify discount codes are not stacking for a Black Friday promotion

Issue

You planned a sitewide sale plus a loyalty, creator or email code, but checkout applies only one, drops a code with "Some discount codes couldn't be used together", or gives a different total than the campaign promised.

Likely causes

  • The combination settings on one of the discounts don't allow the other discount's class.
  • Two product discounts are meant to apply to the same item, which Shopify reserves for Plus stores with reciprocal tags.
  • The store still has checkout.liquid customisations, or the order comes through a channel where combinations don't apply.

What to check first

  • 01Open every discount in the promotion and read its Combinations section side by side.
  • 02Check whether the stack you want puts two product discounts on the same line item.
  • 03Test the exact codes together in a new online store checkout, not a draft order.

When to escalate

Escalate when the promotion relies on Functions-based discounts, discount apps, or migrated Scripts logic, or when finance needs a hard cap on the total discount per order.

Cluster

Storefront and Theme Issues

These are the problems merchants usually experience as broken sections, missing content, or theme behavior that feels inconsistent between preview and live storefront.

Shopify theme changes are not appearing on the live store

Issue

You made a change in the editor or codebase, but the storefront still looks old, inconsistent, or different from the preview.

Likely causes

  • The edit was made on an unpublished theme or the wrong template.
  • A market-specific override is preventing the default version from inheriting the update.
  • Theme app extensions or custom app code are still controlling part of the output.

What to check first

  • 01Confirm the theme you edited is the published theme.
  • 02Check the template and market selector in the theme editor before assuming the change failed.
  • 03Review recent app installs or app embed settings if the section behaves differently than expected.

When to escalate

Escalate when the live store and editor diverge for reasons that are not obvious from theme settings, or when market overrides and app logic are colliding.

A Shopify app is breaking the storefront or theme behavior

Issue

A section disappears, layouts shift, product pages behave strangely, or cart logic changes right after an app install or update.

Likely causes

  • The app injects storefront code, app blocks, or scripts that conflict with theme output.
  • An app embed is active globally even though the feature should only affect one template.
  • Older theme customizations and new app code are both trying to control the same UI.

What to check first

  • 01Audit apps that touch the storefront, cart, product page, or checkout-adjacent experience.
  • 02Disable the relevant app embed or extension temporarily and compare behavior.
  • 03Check whether the issue reproduces on a clean copy of the theme.

When to escalate

Escalate when the issue requires code-level isolation, app-extension cleanup, or a safer replacement for brittle app-driven UI logic.

Add to cart or product content is missing on a product page

Issue

The product page renders, but a critical block such as add to cart, buy buttons, or supporting product content is missing or malformed.

Likely causes

  • The wrong product template is assigned to that product.
  • Section settings, block visibility, or product availability rules are hiding part of the layout.
  • Theme code or rich text content introduced malformed markup around the product section.

What to check first

  • 01Compare the affected product template against a working product.
  • 02Confirm the product is active and available to the Online Store sales channel.
  • 03Check for recent code edits or copied HTML that could break the product section markup.

When to escalate

Escalate when the page is using multiple templates, custom product logic, or broken Liquid that a merchant cannot safely unwind in the editor.

Collection or search filters are not showing on the storefront

Issue

You configured filters in Search & Discovery, but customers still do not see them on collection pages or search results.

Likely causes

  • The theme does not support storefront filtering or the filter display setting is turned off.
  • The collection or search result set is too large for Shopify to display filters.
  • A third-party search setup or theme customization is bypassing Shopify's native filter output.

What to check first

  • 01Confirm the theme supports filtering and that the Product grid or Search results section has filtering enabled.
  • 02Check whether the collection has more than 5,000 products or the result set exceeds Shopify's documented limits.
  • 03Verify the storefront is using Shopify's native search and collection templates rather than a third-party search layer.

When to escalate

Escalate when filters should appear but the store is running custom theme logic, oversized collections, or mixed native and third-party discovery tooling.

Shopify says select a variant when one is already selected

Issue

A shopper chooses an available size or colour, but Add to cart stays disabled, shows a selection error, or sends a 422 response.

Likely causes

  • The variant picker does not populate the product form's variant ID on initial load.
  • Custom theme JavaScript clears or fails to update the hidden variant input.
  • An app script interrupts the theme's option-change event or submits an unavailable variant.

What to check first

  • 01Test a single-variant product and a multi-option product in a clean theme copy.
  • 02Inspect the cart/add request and confirm it contains the selected variant ID.
  • 03Disable storefront apps that replace selectors, bundles, swatches, or product forms.

When to escalate

Escalate when the picker looks selected but the form submits no valid variant ID, or when several scripts compete to control the product form.

Cluster

Checkout and Conversion Issues

Checkout issues usually feel like conversion problems before they feel technical. The goal here is to separate merchant settings issues from extension, app, or platform-specific friction.

The Shopify store is getting traffic but not getting sales

Issue

Sessions show up in analytics, products get viewed, but orders stay at zero or far below what the traffic should produce.

Likely causes

  • Traffic does not match the product: bot sessions, untargeted ads, or visitors from countries you cannot ship to.
  • Checkout is blocked for the buyer: shipping unavailable, missing payment methods, or currency and price surprises.
  • The product page does not earn trust: weak photos, unclear pricing, missing reviews, or slow mobile load.

What to check first

  • 01Look at add-to-cart and reached-checkout rates, not just sessions, to see where the funnel breaks.
  • 02Place a test order from the countries and devices your traffic comes from.
  • 03Compare traffic sources: real search and referral visitors convert very differently from bot or broad social traffic.

When to escalate

Escalate when the funnel numbers point at a specific step, such as checkout, that settings changes do not fix, or when you need a structured conversion audit rather than more guesses.

Checkout Blocks content is not showing in checkout

Issue

You created or configured checkout content, but the block does not appear, save correctly, or behave the way the rule setup suggests it should.

Likely causes

  • The block exists in the app but was not added to the checkout configuration itself.
  • Display rules or permissions do not match the current checkout context.
  • The checkout configuration or market-specific setup differs from the one being tested.

What to check first

  • 01Verify the block is added in the checkout and accounts editor, not just created in the app.
  • 02Re-check the display rules, target configuration, and any market-specific conditions.
  • 03Validate using a realistic test checkout rather than a guessed scenario.

When to escalate

Escalate when custom checkout logic, multiple configurations, or market-specific overrides make it unclear which rule set is actually winning.

Subscriptions, returns, and loyalty tools are not syncing cleanly

Issue

Customers return subscription items, rewards do not reflect recurring orders cleanly, or support teams end up reconciling multiple apps by hand.

Likely causes

  • The stack relies on multiple apps that treat subscriptions, returns, and loyalty as separate systems.
  • Customer state and order state are being updated in one tool but not reflected downstream.
  • The merchant workflow has grown past what app defaults can coordinate safely.

What to check first

  • 01Map which app owns subscription contracts, returns, store credit, and loyalty logic.
  • 02Identify where customer support is compensating manually for tool gaps.
  • 03Check whether key events are synchronized through native integrations, Flow, or custom logic at all.

When to escalate

Escalate when your stack is operationally expensive, support teams are doing manual reconciliation, or recurring revenue workflows now depend on brittle app handoffs.

A Shopify discount code is not applying at checkout

Issue

The discount exists, but checkout says it is invalid, not applicable to the cart, or applies a different discount combination than the merchant expected.

Likely causes

  • The cart does not meet the discount's product, collection, customer, or minimum-spend conditions.
  • The discount cannot combine with another code already present in checkout.
  • The merchant is testing through a draft-order or checkout setup where some discount types are limited or disabled.

What to check first

  • 01Review the discount's active dates, entitlements, minimum requirements, and customer eligibility.
  • 02Check whether another code, automatic discount, or checkout context is overriding the expected outcome.
  • 03If testing draft orders, confirm customer-applied discounts are enabled and account for Shopify's draft-order discount limitations.

When to escalate

Escalate when discount logic spans combinations, market-specific checkout behavior, or custom app rules that merchants cannot safely reason through from the admin alone.

Local payment methods are not showing at checkout

Issue

You enabled regional payment methods, but eligible buyers still do not see them during checkout.

Likely causes

  • The buyer's country is not in an active market or is not eligible for that payment method.
  • The method is not actually activated in Shopify Payments, or conflicting additional gateways are blocking activation.
  • The method has extra eligibility requirements such as country, store setup, or order-volume thresholds.

What to check first

  • 01Confirm the relevant market is active and that the test buyer is checking out from a supported country.
  • 02Verify the payment method is enabled in Shopify Payments and that conflicting additional gateways have been removed if required.
  • 03Review method-specific eligibility requirements before treating the issue as a checkout bug.

When to escalate

Escalate when payment visibility depends on markets, gateway cleanup, or custom checkout expectations that are unclear from a basic admin review.

Shopify store credit is not showing at checkout

Issue

A customer has a positive store-credit balance, but checkout offers no way to apply it or staff cannot use it on an admin-created order.

Likely causes

  • The customer is not signed in through new customer accounts or Shop Pay.
  • Store credit is disabled in Customer accounts, or the balance is in a different checkout currency.
  • The order is a draft, edited, recurring subscription, B2B, or unsupported sales-channel transaction.

What to check first

  • 01Confirm store credit is enabled and the customer is signed in through new customer accounts.
  • 02Match the credit currency to the checkout currency and test a normal Online Store order.
  • 03Check whether the order type or channel is excluded by Shopify's store-credit restrictions.

When to escalate

Escalate when account, currency, and order eligibility are correct but the payment option is still missing, or when a returns app and Shopify credit disagree.

Shopify currency changes back at checkout

Issue

Prices display in a shopper's local currency on product and cart pages, then switch to the store currency when checkout opens.

Likely causes

  • The store uses a gateway that cannot process Shopify Markets local-currency payments.
  • A display-only currency app changes storefront prices but cannot control checkout currency.
  • The selected market, customer country, or locale-aware cart state is inconsistent.

What to check first

  • 01Confirm Shopify Payments or Adyen is the primary gateway for true multi-currency checkout.
  • 02Test the intended market using its country selector, shipping address, and a compatible payment method.
  • 03Remove display-only currency apps from the test and inspect locale-aware cart requests.

When to escalate

Escalate when the gateway supports local currency but theme, cart, market, and checkout contexts still disagree, or when the business needs a multi-store alternative.

Cluster

Inventory, Shipping, and Availability Issues

A large share of Shopify friction sits in the overlap between inventory visibility, fulfillment locations, shipping profiles, and market logic. These issues can quietly suppress conversion.

Shopify says shipping is not available at checkout

Issue

Customers reach checkout, enter an address, and see "Shipping not available", "Your order cannot be shipped to the selected address" or no delivery methods at all, sometimes only for certain products, carts or countries.

Likely causes

  • A product in the cart sits in a shipping profile with no rate for the buyer's zone, or isn't set as a physical product.
  • The location holding the stock is inactive, can't fulfil online orders, or has no rates for that zone.
  • The cart's weight or discounted value falls outside every rate tier, or carrier-calculated rates can't price the package.
  • The buyer's country isn't in a market, or the market has no shipping rates.

What to check first

  • 01Recreate the exact failing cart and address in a new checkout, never an old abandoned one.
  • 02Check the shipping profile, zone and rates for each product in that cart.
  • 03Check the fulfilling location is active and set to fulfil online orders.
  • 04Compare the cart's weight and discounted total against every rate tier.

When to escalate

Escalate when the issue only appears for certain product mixes, markets, or location combinations, when carrier-calculated or app rates are involved, and the configuration logic is no longer obvious.

Products are showing sold out even though inventory exists

Issue

A product has stock somewhere in the system, but customers still see the product as unavailable or cannot complete checkout.

Likely causes

  • Inventory is available in a location that cannot fulfill the buyer's shipping zone.
  • Fulfillable inventory settings and shipping-zone logic are not aligned.
  • Market-specific inventory behavior is exposing edge cases across locations.

What to check first

  • 01Confirm which fulfillment location actually has stock for the buyer's market and shipping zone.
  • 02Review fulfillable inventory settings and whether the store is relying on location rules that changed in 2025.
  • 03Check whether the product is blocked only in specific markets or address scenarios.

When to escalate

Escalate when location-level inventory and market behavior create inconsistent availability that merchants cannot diagnose from the admin alone.

Cluster

Markets, Localization, and Translation Issues

As stores expand internationally, one update can stop inheriting properly across markets. Merchants often read this as a translation problem when it is really an override or context problem.

Markets or translated content are not updating correctly

Issue

A section looks right in the default storefront but stale, untranslated, or inconsistent in a specific market or language.

Likely causes

  • The market has an override, so updates from the default storefront are no longer inherited automatically.
  • Translations are outdated or missing for recently changed content.
  • The editor context is set to a market or language that does not match the content being reviewed.

What to check first

  • 01Verify whether the affected section or block has a market override.
  • 02Update untranslated or outdated content rather than assuming the theme failed.
  • 03Check the market selector in the theme editor before editing or diagnosing further.

When to escalate

Escalate when overrides have proliferated across markets and the store no longer has a clean inheritance model for content or layout changes.

Products or collections are showing different templates unexpectedly

Issue

Some products or collections render with different layout, content, or merchandising logic even though the store should feel consistent.

Likely causes

  • Different templates are assigned across resources without a clear governance rule.
  • A market-specific override changes visibility or ordering of sections.
  • The team is editing one template while diagnosing a different one.

What to check first

  • 01Compare template assignments across affected products or collections.
  • 02Review whether the issue exists only in one market, one language, or one product type.
  • 03Standardize template ownership before making more one-off fixes.

When to escalate

Escalate when the store has accumulated enough template variation that merchandising and engineering changes are no longer predictable.

Cluster

Admin, Catalog, and Data Workflow Issues

When catalog operations start leaning on spreadsheets, hidden metafields, and improvised process, Shopify can become technically correct but operationally expensive.

Bulk editing products or metafields has become manual spreadsheet work

Issue

Simple catalog updates now require CSV exports, repeated imports, or manual clicking through large product sets.

Likely causes

  • Metafield definitions exist, but the team is not using the bulk editor effectively.
  • The catalog has outgrown ad hoc admin workflows and now needs stronger data structure.
  • Variant and product data are split across tools with no single reliable editing pattern.

What to check first

  • 01Audit which fields can be managed directly in Shopify's bulk editor before defaulting to CSV.
  • 02Clean up metafield definitions and naming so the team can find the right fields quickly.
  • 03Separate bulk operational edits from one-off merchandising edits.

When to escalate

Escalate when catalog maintenance is eating team time every week or when data architecture is actively blocking merchandising speed.

The Shopify admin workflow is technically possible, but operationally messy

Issue

The store works, but internal teams are managing repeated exceptions, hidden workarounds, and support overhead to keep it running.

Likely causes

  • The store has accumulated too many half-connected apps solving narrow problems.
  • Operational rules live in people and process rather than structured admin logic.
  • The business is using Shopify beyond the point where default workflows stay efficient.

What to check first

  • 01List the recurring manual tasks the team repeats each week inside the admin.
  • 02Identify which workflows depend on exports, duplicate entry, or cross-tool checks.
  • 03Prioritize the workflows that hurt margin, launch speed, or support load first.

When to escalate

Escalate when the issue is no longer one broken setting and is instead a pattern of admin friction, duplicated effort, or process debt across the store.

The Shopify admin or dashboard is not working or not loading

Issue

The Shopify admin spins, shows a blank page, logs you out, or reports and analytics look empty or wrong even though orders are coming in.

Likely causes

  • A browser extension, stale cookies, or a cached redirect is breaking the admin session.
  • The staff account lacks permission for the section that appears broken.
  • Analytics or reports are missing data because of tracking, app, or date-range issues rather than an admin outage.

What to check first

  • 01Check status.shopify.com and try the admin in an incognito window with extensions disabled.
  • 02Confirm the staff account has permission for orders, analytics, or the app that fails to open.
  • 03Compare the Orders list against the Analytics overview for the same date range before assuming data is lost.

When to escalate

Escalate when the admin loads but store data, reports, or app screens are inconsistent, which usually points to an app, tracking, or integration problem rather than Shopify itself.

Customers are not receiving Shopify order confirmation emails

Issue

Orders are being created successfully, but some or all customers cannot find the order confirmation, even after checking spam folders.

Likely causes

  • The branded sender domain is missing Shopify's DKIM/SPF CNAME records or has no valid DMARC record.
  • Multiple or overly strict DMARC records cause authentication checks to fail.
  • The notification template, recipient address, or an email-provider filter is responsible rather than order creation.

What to check first

  • 01Send a test notification and confirm the affected order contains the correct customer email.
  • 02Check the sender email status and authenticate the domain through Shopify.
  • 03Verify DKIM/SPF CNAME records and exactly one valid DMARC TXT record at the domain host.

When to escalate

Escalate when DNS authentication passes but delivery still fails across providers, or when heavily customised Liquid templates produce inconsistent output.

Recent Shopify changes

Platform behavior changed. Merchant expectations did not.

These changes matter because they directly affect availability, checkout success, and how inventory behaves by market. If a store suddenly feels inconsistent, the admin setup might not be wrong so much as out of date with current platform logic.

September 25, 2025

Configured shipping zones now decide where stocked products can actually be sold

Shopify removed the older behavior that allowed products to sell outside the shipping zones supported by the fulfillment location holding the inventory.

If a product appears unavailable or checkout fails for certain destinations, inventory may exist but still be unsellable for that buyer's zone. This change reduced overselling, but it also exposed weak shipping-profile setup in many stores.

Read changelog item ↗

January 20, 2026

Market-specific inventory logic became more accurate at checkout

Shopify improved checkout availability so buyers can purchase against the inventory that actually serves their market, even when other locations show negative or zero stock.

This fixed some false sold-out scenarios, but it also made cross-market inventory behavior more important to understand. If your availability looks inconsistent by region, market-aware inventory logic is now part of the diagnosis.

Read changelog item ↗

Shopify troubleshooting FAQ

The Shopify problems merchants search for most, answered first.

Why is my Shopify admin or dashboard not working?

Most admin outages are local: a browser extension, an expired session, a cached redirect, or a staff account without the right permissions. Check status.shopify.com, try an incognito window, then confirm the staff permissions. If reports are missing data rather than the admin failing to load, the problem is usually tracking or an app, not Shopify.

Read the full guide →

Why am I not getting sales on Shopify?

Separate a traffic problem from a conversion problem. If sessions are near zero, the store is not being found. If sessions exist but nobody buys, work backwards from checkout: shipping availability, payment methods, price and trust signals on the product page, and whether the traffic matches the product at all.

Read the full guide →

Why are my Shopify theme changes not showing on the live store?

Usually the edit was saved on an unpublished theme, the wrong template, or a market override is still serving old content. Confirm the published theme, the template and market selector in the editor, and any app embeds controlling that section.

Read the full guide →

Why does Shopify say shipping is not available at checkout?

The buyer's address falls outside a shipping zone attached to the location holding the inventory, or the product sits in a shipping profile with no matching rate. Check profiles, zones, locations, and market conditions before touching the theme.

Read the full guide →

Why are my products not showing in Shopify search results?

Products need to be active, published to the Online Store channel, in stock or set to continue selling, and indexed. Search apps and predictive-search theme code can also hide variants and SKUs.

Read the full guide →

How do I get help with a Shopify problem that support cannot fix?

Shopify support covers platform settings and billing. Theme code, app conflicts, checkout extensions, and custom logic are outside their scope. That is where a Shopify developer isolates the layer causing the problem and ships a fix.

Read the full guide →

Escalation path

If the issue is costing revenue, time, or team confidence, stop treating it like a minor admin task.

Thought Bulb helps Shopify brands investigate the real cause, clean up the technical or operational bottleneck, and ship a fix without guesswork. If you have already burned time inside apps, templates, or shipping settings, this is the point to escalate.

Talk to Thought Bulb