Add HowTo JSON-LD schema type #63

New Issue

2026-06-23T13:30:52Z

jmiller commented

2026-06-23 13:30:52 +00:00

Summary

Add HowTo JSON-LD structured data support for step-by-step instructional content.

Why

Google renders HowTo as rich snippets with numbered steps and images
Rank Math (free), Yoast, SEOPress, and AIOSEO all support this
Second most impactful schema type after FAQ for content sites

Implementation

Add a repeatable steps fieldset (step name, text, optional image)
Optional: total time, estimated cost, supply/tool lists
Build HowTo schema in JsonLdBuilder:

{
  "@type": "HowTo",
  "name": "How to...",
  "step": [
    {
      "@type": "HowToStep",
      "name": "Step 1",
      "text": "Do this...",
      "image": "https://..."
    }
  ]
}

## Summary Add `HowTo` JSON-LD structured data support for step-by-step instructional content. ## Why - Google renders HowTo as rich snippets with numbered steps and images - Rank Math (free), Yoast, SEOPress, and AIOSEO all support this - Second most impactful schema type after FAQ for content sites ## Implementation - Add a repeatable steps fieldset (step name, text, optional image) - Optional: total time, estimated cost, supply/tool lists - Build `HowTo` schema in `JsonLdBuilder`: ```json { "@type": "HowTo", "name": "How to...", "step": [ { "@type": "HowToStep", "name": "Step 1", "text": "Do this...", "image": "https://..." } ] } ```

jmiller added this to the v2.0 — Schema & UX Expansion milestone 2026-06-23 13:30:52 +00:00

jmiller added the enhancement label 2026-06-23 13:30:52 +00:00

jmiller commented

2026-06-23 13:30:59 +00:00

Branch created: feature/63-add-howto-json-ld-schema-type

git fetch origin
git checkout feature/63-add-howto-json-ld-schema-type

Branch created: [`feature/63-add-howto-json-ld-schema-type`](https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteOpenGraph/src/branch/feature/63-add-howto-json-ld-schema-type) ```bash git fetch origin git checkout feature/63-add-howto-json-ld-schema-type ```

jmiller referenced this issue from a commit

2026-06-23 17:19:40 +00:00

feat: add FAQ, HowTo, Event, and Recipe JSON-LD schema types

jmiller closed this issue

2026-06-23 17:20:06 +00:00

Sign in to join this conversation.

Priority Medium

Type Feature

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: MokoConsulting/MokoSuiteOpenGraph#63