Solving Shopify Cart 'Item Unavailable' Errors: A Community Troubleshooting Guide

Hey fellow store owners! Ever hit that brick wall where a product is clearly in stock, visible to the world, but your cart stubbornly insists it's "unavailable" when a customer tries to add it? You're not alone. This exact frustration recently popped up in the Shopify community, and it sparked some really insightful discussion. Our friend pepino was wrestling with this on their store, aethrielarchive.com, using the Horizon template, and the thread quickly uncovered a common culprit: a 422 Unprocessable Content error on the cart/add.js request. Sounds technical, right? Don't worry, we're going to break it down, just like the community did, and give you a clear path to troubleshooting.

When you see a 422 error, as Maximus3 helpfully pointed out, it's not that Shopify didn't understand your request – it just refused to process it. This usually points to something specific about the item you're trying to add, like inventory issues or a variant ID problem. But the real kicker, as pepino confirmed, was that cart/add.js was throwing this error, often leading to a 'Sold out' message even when stock was available. So, what's really going on?

The Obvious Suspects – Inventory & Product Settings

Before we dive into anything too complex, let's cover the basics. Sometimes, the simplest explanation is the right one. As emilyjhonsan98 and Maximus3 both highlighted, inventory and product settings are often the first place to look.

Here’s a quick checklist to run through in your Shopify Admin:

  1. Check Your Stock Levels: Go to your Shopify Admin, navigate to the specific product page (like pepino's "Khriò Weathered Belt Boots"). Scroll down to the Inventory section. Even if it says '1 in stock', double-check it's truly available and not reserved for drafts or other specific scenarios.
  2. "Continue Selling When Out of Stock" Setting: If your stock is at 0 (or you want to allow backorders), make sure the checkbox that says "Continue selling when out of stock" is checked. If this is unchecked and stock hits zero, your cart will indeed block the checkout.
  3. Fulfillment & Locations: Tim_1 wisely added that it's crucial to "Ensure that you have location(s) and delivery method(s) which can actually fulfil the item." Sometimes, even with stock, if Shopify can't figure out where or how to fulfill it, it throws a wrench in the works.
  4. Market Restrictions: Maximus3 also suggested checking "any other setting like market restrictions." If your product is restricted from being sold in certain regions, and a customer from that region tries to add it, you could see this kind of error.

Is Your Theme Playing Tricks? The Quick Test

Okay, you've confirmed your inventory and product settings are solid. What next? The community consensus, especially from Maximus3, emilyjhonsan98, and tim_1, was to quickly rule out your theme. This is often the quickest diagnostic step when you suspect a code issue.

Here’s how to do it:

  1. Preview a Default Theme: In your Shopify Admin, go to Online Store > Themes. Find a default Shopify theme like Dawn (it's usually pre-installed or easy to add). Don't publish it! Just click "Actions" > "Preview".
  2. Test the Product: While in the preview of the default theme, navigate to the problematic product page and try to add it to the cart.

What does this tell you?

  • If it works in the default theme: Bingo! As emilyjhonsan98 put it, "you’ll know the issue is a broken template file inside your Horizon theme code that needs to be re-mapped." This points to a JavaScript error or a broken Variant ID being passed by your custom theme (like pepino's Horizon template).
  • If it still doesn't work in the default theme: Then, as Maximus3 suggested, "Most likely not theme related." This shifts your focus back to broader inventory, app conflicts, or core Shopify settings.

When Apps & Code Get Involved – Deeper Dives

If the theme test points to your custom theme, or if the issue persists even with a default theme, it's time to put on your detective hat and dig into potential app conflicts or deeper JavaScript issues.

rshrivastava63 specifically noted seeing "some errors in console, which is might be related to some JS conflicts in code." They even shared a screenshot of console errors, which is a fantastic place to start looking:

Here’s how to tackle this:

  1. Inspect Your Browser Console: Open your browser's developer tools (usually F12 or right-click > Inspect). Go to the 'Console' tab. Look for any red error messages when you try to add the product to the cart. These can give you clues about conflicting scripts or missing elements.
  2. Systematic App Troubleshooting: As rshrivastava63 recommended, "Please troubleshoot by doing one by one uninstalling app you store, specifically related cart and cookies." This is a painstaking but often effective method. Start with recently installed apps, or any app that interacts with your cart, product pages, or cookies. Uninstall one, test. If the problem goes away, you've found your culprit.
  3. Variant ID Validity: Maximus3 brought up "variant ID validity" as a potential cause for the 422 error. If your theme's JavaScript isn't correctly sending the product's unique variant ID to cart/add.js, Shopify won't know what to add, leading to that unprocessable content error. If your theme test failed, this is a strong indicator that your theme's code might need a closer look by a developer.

The key takeaway from this community discussion is that a 'cart not working' error, especially a 422, can stem from several places. It's rarely a single, obvious fix. By systematically checking your inventory, testing your theme, and then diving into app conflicts or console errors, you can narrow down the problem and get your Shopify store back to smoothly processing those crucial customer orders. Happy selling!

Share:

Use cases

Explore use cases

Agencies, store owners, enterprise — find the migration path that fits.

Explore use cases