Hey everyone! As a Shopify migration expert, I spend a lot of time digging through our fantastic community forums, and every now and then, a thread pops up that’s just gold. Recently, I stumbled upon a discussion started by Krissy101 about refreshing her Shopify store and getting its page structure right for AI crawlers. It’s a topic near and dear to my heart, and the insights shared by folks like ryan-bowne and liquidshop.co were too good not to share with you all in a more digestible format.

Krissy was wondering if using a standard page template with bullet points for specs was better than using theme templates, specifically asking if it would make a difference for AI crawling. This is a common question, and the answer, as ryan-bowne wisely pointed out, boils down to a fundamental principle:

The Golden Rule: Real Text in Rendered HTML

Forget whether it’s a standard page or a fancy theme template. What truly matters for AI crawlers, like Google’s, is what actually shows up as real text in the server-rendered HTML on load. If your crucial product details, specs, or descriptions are being loaded in by JavaScript *after* the page initially renders, or if they're hidden inside an image or a tab that only opens on click, AI engines will likely miss them. They need to see it plain as day in the page source.

So, the takeaway here is clear: “Standard page or theme template, either works. Keep it simple and consistent across page types. Do not split content across template variants just for AI.” Consistency and directness are your friends!

Structuring Your Content for AI & Humans Alike

Let's dive into the practical advice for refreshing your product pages:

1. Specs & Details: Make Them Visible and Structured

• Bullet Points are Your Best Friend: Ryan-bowne stressed that specs should be a real bulleted list in the page body, with clear labels (think material, size, weight, use case). AI models read these cleanly. This directly addresses Krissy's question about putting size info in dropdowns. If your size specs are currently hidden in a dropdown box, you're likely making it harder for AI to find and understand that critical data. Pull them out and bullet-point them directly on the page!

• Clear Headings: Use one

  per page for your main product title. Then, use

  and

  tags that echo how a customer might naturally ask questions about your product. This isn't just good for AI; it's fantastic for user experience too.

• Short FAQ Block: Include a small FAQ section (3-5 common questions) in plain question-and-answer text. It’s a simple way to capture common queries and provide structured information.

Demystifying Schema (JSON-LD): Your Secret Weapon for AI

This was a big part of the discussion, and for good reason. Krissy asked, "what is schema?" and "is it something that goes in the liquid pages or somewhere on the shopify product page?" This is where structured data, specifically JSON-LD schema, comes into play.

Think of schema as a special language that helps search engines (and thus AI crawlers) understand the context of your page. While your human-readable descriptions tell customers about your product, schema tells search engines, in a machine-readable format, that this is a "Product," its "price" is X, its "brand" is Y, and it's "InStock." This can lead to those coveted "rich results" in search, like star ratings or price directly in Google.

Liquidshop.co provided an excellent, actionable guide on how to implement this:

How to Add Product Schema (JSON-LD) to Your Shopify Store

First, it's wise to check if you already have it or if it's incomplete. Paste any product URL into Google’s Rich Results Test to confirm.

If you need to add or improve it, here's how (always back up your theme before making code changes!):

1. Create a new snippet: In your Shopify theme code editor (Online Store > Themes > Actions > Edit code), go to the "Snippets" directory.

2. Add a new file: Click "Add a new snippet" and name it product-schema.liquid. Paste the following code into this new file:

3. Include the snippet in your product template: Open templates/product.json or sections/main-product.liquid (the exact file depends on your theme, but it's usually one of these for product pages). Add this line near the top:

   {% render 'product-schema' %}
   

4. Test Your Changes: After saving, go back to Google’s Rich Results Test and re-enter your product URL to ensure the schema is now correctly detected and parsed.

This snippet ensures that essential product information like name, description, URL, image, brand, price, currency, and availability is presented to AI crawlers in a structured, machine-readable format. Remember what ryan-bowne said: "make sure it lands in the page source rather than getting injected by JavaScript, or AI crawlers can miss it." This method ensures it's in the source.

A Quick Check for Any Page

Before we wrap up, here’s a super handy tip from ryan-bowne to quickly check if your content is visible to crawlers:

• Open any product page on your store.
• Right-click anywhere on the page and select "View Page Source" (or "Inspect Element" and then look for the "Source" tab).
• Use your browser's search function (Ctrl+F or Cmd+F) and search for some of your specific product text or specs.

If your text appears in the source code, crawlers can see it. If it only shows up on the live page but not in the source, it's likely being injected by JavaScript, and that's the first thing you'll want to fix for better AI visibility.

So, whether you're doing a total refresh like Krissy or just fine-tuning, focusing on clear, accessible content, proper heading structure, and robust JSON-LD schema will make a huge difference in how AI crawlers understand and rank your Shopify store. It's all about making your store's information as easy to digest as possible, both for your customers and for the algorithms that help them find you.