How-to Structured Data

The HowTo structured data or content walks users through a set of steps to successfully complete a task, and can feature video, images, and text.

Properly marked up how-to pages may be eligible to have a rich result on Search and an Action on the Google Assistant, which can help your site reach the right users.

Required Properties

  • name (Text): The title of the how-to.

  • step (HowToStep or HowToSection): An array of HowToStep elements which comprise the full instructions. Each step element should correspond to an individual step in the instructions. Don't mark up non-step data such as a summary or introduction section.


You can specify the complete text for each step by setting the text of each HowToStep. An image, step-title given as name, and url are optional, but recommended, since optional properties may contribute to a rich presentation of the search result.

Required Properties

  • itemListElement (HowToDirection or HowToTip): A list of detailed substeps, including directions or tips. Optional if text is used.

  • text (Text): The full instruction text of this step.


The HowToSection type defines a section of a single how-to and contains one or multiple steps.

Required Properties

  • itemListElement (HowToStep): A list of detailed steps for the section.

  • name (Text): The name of the section.

Star ActiveStar ActiveStar ActiveStar ActiveStar Active