Docs
← Back to site

SEO: Schema, TechArticle & Breadcrumbs

2 min readUpdated November 21, 2026

WP Super Docs adds structured data and breadcrumb markup to your docs automatically, without needing a separate SEO plugin. If you do have one active, most of it steps aside to avoid conflicting output.

Meta description#

Under a doc’s SEO panel, you can set a meta description (recommended 120 to 160 characters). If you have Yoast, Rank Math, Slim SEO, SEOPress, or All in One SEO active, that plugin’s own meta description field takes over on the frontend instead, and WP Super Docs’ field becomes a fallback only, kept in case you ever remove the SEO plugin later.

The Built-in SEO meta settings on the SEO tab.

TechArticle schema#

Every doc automatically outputs TechArticle structured data (a schema.org type built for technical documentation, more specific than a generic Article), including the title, description, publish and modified dates, author, and publisher. This schema is skipped entirely if any of the five supported SEO plugins listed above is active, since that plugin will output its own article schema and having both would be redundant.

The Breadcrumbs settings: show breadcrumbs, structured data, separator and home label.

A breadcrumb trail (Home › Product › Category › Doc Title) appears on doc pages, controlled independently under Settings → Setup → Content:

  • Enable breadcrumbs: on by default.
  • Separator: the character between crumbs, › by default.
  • Home label: the text for the first crumb, “Docs” by default.
  • Breadcrumb schema: also emits a matching BreadcrumbList JSON-LD block, on by default.

Unlike the TechArticle schema, breadcrumb schema does not check whether an SEO plugin is active before emitting. If your SEO plugin is also configured to output its own breadcrumb schema (Yoast, for example, can do this if you’ve enabled it in its own settings), you could end up with two separate BreadcrumbList blocks on the same page. This is unlikely to cause serious harm, but if you notice duplicate breadcrumb schema in a rich-results testing tool, turn off Breadcrumb schema here and rely on your SEO plugin’s version instead.

Was this helpful?

This website uses cookies to enhance your browsing experience and ensure the site functions properly. By continuing to use this site, you acknowledge and accept our use of cookies.

Accept All Accept Required Only