Optimization Guide

Shopify HowTo Assembly & Instructions Schema for AI Shopping Agents

AI shopping agents now answer "how long does it take to assemble the X bookshelf?" and "what tools do I need to install the Y faucet?" directly in chat. Shopify generates Product schema but zero HowTo markup — so those queries send buyers to whichever competitor has the step-by-step structured data.

TL;DR Add a "@type": "HowTo" JSON-LD block to products with assembly, setup, or installation steps. Include totalTime (ISO 8601 duration), tool (array of HowToTool), and step (array of HowToStep with name and text). Store step data in an instructions.steps metafield (json type) so it scales without hardcoding per product.

The Post-Purchase Query Gap

Assembly and setup queries are a large, underserved search category for physical products. A shopper who has already decided to buy the product — or who is comparing two products partly based on setup complexity — is searching "how do I assemble the X standing desk" or "XYZ coffee maker setup instructions." In 2026, many of these queries go directly to AI assistants rather than Google.

Without HowTo schema, AI agents either extract instructions from unstructured description text (imprecise and unreliable) or direct users to YouTube (away from your site). With HowTo schema, your product page becomes the authoritative source the AI cites — keeping the post-purchase relationship on your domain, improving customer satisfaction, and reducing support ticket volume for "how do I set this up."

Product categories with high HowTo schema ROI

CategoryTypical queryKey HowTo properties
Flat-pack furniture "how to assemble X bookcase" totalTime, tool (Allen key, screwdriver), numbered step array
Exercise equipment "how long to set up X treadmill" totalTime PT60M, tool (wrench, bolt), supply (safety key)
Smart home / IoT "how to pair X smart plug to Alexa" Software-setup steps — no tool needed; supply: smartphone, Wi-Fi credentials
Plumbing / fixtures "how to install X kitchen faucet" tool (adjustable wrench, plumber's tape), supply (shut-off valve), safety warning step
Children's play equipment "how many people needed to assemble X swing set" totalTime, performTime, tool, note "requires 2 adults" in step text
Subscription / SaaS products "how do I set up X subscription box" Onboarding steps — account creation, preference selection, first delivery scheduling

HowTo Schema Structure for Shopify

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "How to Assemble the Apex Pro Standing Desk",
  "description": "Full assembly instructions for the Apex Pro sit-stand desk.
    Requires two people and approximately 45 minutes.",
  "totalTime": "PT45M",
  "tool": [
    { "@type": "HowToTool", "name": "Allen key (4mm) — included" },
    { "@type": "HowToTool", "name": "Phillips screwdriver" }
  ],
  "supply": [
    { "@type": "HowToSupply", "name": "Apex Pro Standing Desk (all box contents)" }
  ],
  "step": [
    {
      "@type": "HowToStep",
      "position": 1,
      "name": "Lay out all parts",
      "text": "Open all boxes and lay parts flat on the floor. Match each part
        against the parts list on page 2 of the included manual. Check for
        any damaged components before starting assembly."
    },
    {
      "@type": "HowToStep",
      "position": 2,
      "name": "Attach the leg uprights to the crossbars",
      "text": "Insert the left upright into the left crossbar bracket and hand-tighten
        the M8 bolt using the included Allen key. Repeat for the right side.
        Do not fully tighten until all four connection points are engaged."
    },
    {
      "@type": "HowToStep",
      "position": 3,
      "name": "Mount the desktop surface",
      "text": "With a second person supporting the desktop, align the pre-drilled
        holes with the upright mounting points. Insert M6 bolts and tighten
        in a cross pattern to ensure even pressure."
    },
    {
      "@type": "HowToStep",
      "position": 4,
      "name": "Connect the control cable and power",
      "text": "Route the motor control cable through the cable management slot and
        connect to the handset. Plug the power adapter into the motor unit,
        then into a grounded outlet. The handset display will illuminate green."
    },
    {
      "@type": "HowToStep",
      "position": 5,
      "name": "Run the calibration cycle",
      "text": "Hold the down arrow on the handset until the desk reaches its
        lowest position and stops automatically. This calibrates the motor
        range. Assembly is complete."
    }
  ]
}
</script>

Metafield-driven approach (scales to full catalog)

{% if product.metafields.instructions.steps %}
  {% assign steps = product.metafields.instructions.steps.value %}
  <script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "HowTo",
    "name": "How to assemble {{ product.title | escape }}",
    "totalTime": {{ product.metafields.instructions.total_time.value | json }},
    "tool": {{ product.metafields.instructions.tools.value | json }},
    "step": [
      {% for step in steps %}
      {
        "@type": "HowToStep",
        "position": {{ forloop.index }},
        "name": {{ step.name | json }},
        "text": {{ step.text | json }}
      }{% unless forloop.last %},{% endunless %}
      {% endfor %}
    ]
  }
  </script>
{% endif %}

Schema Reference

PropertyTypeRequiredNotes
@typeTextYesHowTo
nameTextYes"How to assemble [product name]" — match H1 on page
descriptionTextRecommendedBrief summary including difficulty and time expectation
totalTimeDuration (ISO 8601)RecommendedPT30M = 30 min, PT1H30M = 1.5 hr. Unlocks "how long" AI answers.
toolArray of HowToToolRecommendedName each required tool. Note "(included)" if packed in box.
supplyArray of HowToSupplyOptionalMaterials consumed (not tools) — e.g., "AA batteries (2)"
stepArray of HowToStepYesEach step needs name (short label) and text (full instruction). Add position integers.
imageImageObjectOptionalStep-level images improve rich result appearance in Google Images

What CatalogScan Checks

FAQ

My product has a YouTube assembly video — do I still need HowTo schema?

Yes. A YouTube video helps human visitors but AI shopping agents cannot watch videos. They rely on text-based structured data. You can reference the video in HowTo schema using the video property (VideoObject with contentUrl pointing to YouTube), but the step-by-step text in HowToStep is still required for AI visibility. Both the video and the schema serve different audiences — don't choose one over the other.

Should HowTo schema go on the product page or a separate instructions page?

Product page is preferred. Shoppers searching "how to assemble [product name]" typically land on the product page through organic search. Placing HowTo schema there captures both the purchase intent and the post-purchase intent in a single URL. A separate instructions page is reasonable for complex products with very long step lists (10+ steps), but ensure it is canonically linked from the product page and included in your sitemap.

Does HowTo schema affect Google rich results for product pages?

Yes. HowTo can trigger rich results in Google Search showing the numbered steps directly in the SERP, potentially replacing the standard blue-link result with an expandable step list. This is particularly valuable for assembly queries where users want to preview the complexity before clicking. Google's eligibility requirements: steps must be visible on page, totalTime recommended, minimum 2 steps.

Audit Your Products for HowTo Schema

CatalogScan identifies products that likely require assembly instructions but lack HowTo structured data. Get your AI readiness score and a prioritized implementation checklist in under 2 minutes.

Scan your store free