HowToSection

HowToSection dual-inherits from ListItem and CreativeWork. It is a grouping construct for long HowTo guides: "Preparation", "Assembly", "Finishing" — each section contains its own HowToStep or HowToDirection entries.

Use HowToSection when a HowTo is long enough that grouping improves comprehension. For short guides (fewer than 8-10 steps), a flat list of HowToStep entries is usually clearer.

Full example of schema.org/HowToSection json-ld markup

The markup is verified as valid with Rich Results Test from Google.

Highlight legend:Required by GoogleRecommendedOptional

schema.org/HowToSection

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "Build a barcode-scanner stand for your checkout counter",
  "step": [
    {
      "@type": "HowToSection",
      "name": "Preparation",
      "itemListElement": [
        { "@type": "HowToStep", "name": "Gather materials", "text": "Collect the acrylic sheet, acrylic glue, and a craft knife." },
        { "@type": "HowToStep", "name": "Clear the workspace", "text": "Work on a flat, well-lit, ventilated surface." }
      ]
    },
    {
      "@type": "HowToSection",
      "name": "Assembly",
      "itemListElement": [
        { "@type": "HowToStep", "name": "Cut the base", "text": "Cut a 15 cm x 15 cm square from the acrylic sheet." },
        { "@type": "HowToStep", "name": "Glue the upright", "text": "Glue the upright to the centre of the base at a 30-degree angle." },
        { "@type": "HowToStep", "name": "Let it cure", "text": "Let the glue cure for 24 hours before use." }
      ]
    }
  ]
}
</script>

Minimal valid version

The smallest markup that still produces a valid HowToSection entity. Use it as the floor. Reach for the advanced example above when you want search engines and AI agents to understand more about your content.

schema.org/HowToSection (minimal)

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "HowToSection",
  "name": "Preparation",
  "itemListElement": [{ "@type": "HowToStep", "name": "Gather materials" }]
}
</script>

Google rich results this unlocks

Markup matching this example makes your page eligible for the following Google Search rich results. The primary target drives the required / recommended property classification in the advanced code block above.

No dedicated rich result (HowTo rich result deprecated by Google in 2023, still consumed by AI assistants)
Google docs

Common HowToSection mistakes

Mistakes that pass validation but silently fail to earn rich results or mislead consumers walking the graph. Avoid these and your markup will be ahead of most sites in the wild.

01
HowToSection for a short guide
Wrong
```
Single HowToSection wrapping a 3-step guide
```
Right
```
Flat HowToStep list for short guides
```
Sections add ceremony; they only pay off when the guide is long enough to benefit from grouping.

Schema properties in this example

HowToSection ListItem CreativeWork HowTo name step itemListElement HowToStep text

About the example data

The two sections ("Preparation" and "Assembly") of Xoo Code's DIY barcode-scanner stand guide.

Comments

Loading comments...