Skip to content

How to publish a Guide that emits HowTo schema

How to publish a Guide that emits HowTo schema
  1. Use the Guide template.
  2. Start the body with numbered steps.
  3. Keep the outcome in the excerpt (300 characters).
  4. Avoid wrapping the whole post in one paragraph — steps cannot be inferred.
  5. Add a cover image if the Guide will be shared.

If you wrote a narrative essay, use Article instead.

5 replies

Campus note: we added the course entity after step 2. Worked.

Permalink

Bookmarking. The 'do not delete permalinks' line needs to be in onboarding too.

Permalink

We followed it on a Friday deploy. HowTo steps showed up in View Source.

Permalink

Printed this for volunteer mods. Step 3 is the one people skip.

Permalink

Thanks — leaving this up for the next team that searches the same string.

Permalink

Weekly winners

How to publish a Guide that emits HowTo schema

  1. Use the Guide template.
  2. Start the body with numbered steps.
  3. Keep the outcome in the excerpt (300 characters).
  4. Avoid wrapping the whole post in one paragraph — steps cannot be inferred.
  5. Add a cover image if the Guide will be shared.

If you wrote a narrative essay, use Article instead.

Replies 5

Tomás Herrera

@tomas_sre

Campus note: we added the course entity after step 2. Worked.

Elena Rostova
ModMember

@elena_support

Bookmarking. The 'do not delete permalinks' line needs to be in onboarding too.

Maya Lin
Member

@maya_cloud

We followed it on a Friday deploy. HowTo steps showed up in View Source.

Leo Mensah

@leo_ops

Printed this for volunteer mods. Step 3 is the one people skip.

Tomás Herrera

@tomas_sre

Thanks — leaving this up for the next team that searches the same string.

Join the conversation

Sign in or create an account to share your thoughts, solutions, or feedback.