Solving Shopify Cart Errors: When 'Item Unavailable' Isn't About Stock

Ever hit that "Add to Cart" button on your Shopify store, only to be met with a frustrating "Item Unavailable" message, even when you know you have stock? It's a real head-scratcher, isn't it? This exact scenario recently sparked a lively discussion in the Shopify community forum, and I wanted to break down the expert insights shared there. This problem is more common – and fixable – than you might think.

The original poster, @pepino, was using the Horizon template and found their cart wasn't working, consistently showing an item as unavailable despite being public and having 1 unit in stock. They suspected a code problem, specifically pointing to a cart/add.js 422 (Unprocessable Content) error. This 422 status code is crucial: it means Shopify understood the request to add an item to the cart, but couldn't process it – it "refused" it, as one expert, Maximus3, put it. This isn't just a simple invalid request; it's a specific refusal usually due to underlying data issues.

Understanding the "422 Unprocessable Content" Cart Error

When you see that 422 error, it's a strong signal that the problem isn't necessarily a broken request, but rather an issue with the data being sent or the conditions on Shopify's end. As the community discussion unfolded, several key culprits emerged, and it became clear that while it could be theme-related, it often points to deeper inventory, variant ID, or app conflicts.

The Usual Suspects: What Our Experts Pointed To

• Inventory & Fulfillment: This was a primary focus. Maximus3 noted a 422 error often relates to "inventory or variant ID validity." Emilyjhonsan98 provided a fantastic, actionable tip: "Go to your Shopify Admin, open the Khriò Weathered Belt Boots product page, and scroll down to the Inventory section. If the stock is at 0 but you still want customers to be able to purchase it, check the box that says Continue selling when out of stock. If this box is left unchecked, the cart will automatically block the checkout." Tim_1 also added, "Ensure that you have location(s) and delivery method(s) which can actually fulfil the item."
• Theme & JavaScript Conflicts: While Maximus3 initially leaned away from the theme being the primary culprit, @pepino's original diagnosis of a cart/add.js issue brought the theme's JavaScript into focus. Emilyjhonsan98 echoed this, suggesting that if inventory is fine, "your theme’s JavaScript is likely passing a blank or broken Variant ID to the cart form." Rshrivastava63 also spotted "some errors in console, which is might be related to some JS conflicts in code."
• App Interference: Another common cause is a conflict with an app. Maximus3 mentioned, "Some apps could cause the ID mismatch also," and rshrivastava63 advised troubleshooting by "doing one by one uninstalling app you store, specifically related cart and cookies."

Your Step-by-Step Troubleshooting Playbook for Cart Errors

Based on the community's collective wisdom, here's a systematic approach to tackle that pesky "Item Unavailable" error and the underlying 422 response:

1. Double-Check Your Inventory & "Continue Selling" Settings

   This is the first and easiest check, as highlighted by emilyjhonsan98. Even if you think you have stock, re-verification is key.

   • Go to your Shopify Admin > Products > All products.
   • Find the problematic product.
   • In the Inventory section, verify quantity.
   • If stock is low/zero and you want sales to continue, ensure "Continue selling when out of stock" is checked.
   • Also, confirm market restrictions aren't affecting availability.

2. Test with a Fresh, Default Theme (Like Dawn)

   This brilliant diagnostic step, suggested by Maximus3, emilyjhonsan98, and tim_1, quickly determines if your current theme (like pepino's Horizon template) is the source of the problem.

   • In Shopify Admin, go to Online Store > Themes.
   • Under Theme library, find a default theme like Dawn (add it if needed).
   • Click Actions > Preview on the Dawn theme.
   • While in preview, try adding the problematic product to the cart.
   • If it works in Dawn: The issue is likely within your Horizon theme's code (e.g., a broken template file or JavaScript passing a "blank or broken Variant ID"). Investigate your theme's cart/add.js or related files.
   • If it still doesn't work in Dawn: The problem points towards inventory, app conflicts, or fulfillment settings.

3. Inspect Your Browser Console for JavaScript Errors

   Rshrivastava63 specifically noted seeing "some errors in console." This is where you can see the 422 (Unprocessable Content) error directly.

   • On your product page, open your browser's developer tools (right-click > "Inspect" or F12).
   • Go to the "Console" and "Network" tabs.
   • Try adding the product to the cart.
   • Look for red error messages in the "Console" tab, which can indicate JS conflicts.
   • In the "Network" tab, find the /cart/add request. Check its "Status" (should be 422) and the "Response" tab for details on why Shopify rejected it. This screenshot from rshrivastava63 is a great example:

4. Review and Temporarily Disable Apps

   If the theme test didn't resolve it, and inventory is confirmed, look at your installed apps. Apps (especially those modifying carts, product options, or cookies) can sometimes interfere with the add-to-cart functionality by altering the Variant ID or other data.

   • In your Shopify Admin, go to Apps.
   • List apps that interact with product pages, cart, or checkout.
   • Temporarily uninstall or disable these apps one by one, testing cart functionality after each. Start with recent or cart-related apps.
   • If removing an app fixes it, you've found your culprit! Reinstall it and contact the app developer or find an alternative.

5. Verify Fulfillment Locations and Delivery Methods

   As tim_1 pointed out, it's not just about having stock, but also about being able to fulfill it. This is relevant for stores with multiple locations or specific shipping zones.

   • In Shopify Admin, go to Settings > Locations. Ensure your product is assigned to a stocked location.
   • Go to Settings > Shipping and delivery. Confirm shipping profiles and zones are correctly set up for the product and customer locations.

Dealing with cart errors can be frustrating, but as this community discussion shows, a systematic approach can help you pinpoint the exact cause. Whether it's a simple inventory setting, a theme-specific JavaScript hiccup, or an app conflict, methodically going through these steps will get your "Add to Cart" button working smoothly again for your customers. Happy selling!