TechArticle Schema

TechArticle marks up technical how-to content, tutorials, and documentation with metadata about prerequisites and difficulty level. It extends the standard Article type with two additional properties (dependencies and proficiencyLevel) that help search engines and AI systems match technical content to users at the right skill level.

When to use TechArticle

Use TechArticle on pages that contain step-by-step technical instructions, code tutorials, API documentation, hardware setup guides, or any article where the reader needs specific tools or knowledge before they can follow along.

TechArticle is a subtype of Article, which inherits from CreativeWork and Thing. All standard Article properties (headline, author, datePublished, image) apply to TechArticle as well.

Google rich result support

Google does not have a dedicated structured data feature for TechArticle. Standard Article rich results may apply (headline, author, date), but the TechArticle-specific properties (dependencies, proficiencyLevel) do not trigger any special display. These properties are still valuable for AI answer engines that filter content by skill level.

Fields

Not mentioned by Google

These fields are defined by schema.org but are not referenced in any Google structured data documentation.

• proficiencyLevel — Text
• dependencies — Text

JSON-LD example

{
  "@context": "https://schema.org",
  "@type": "TechArticle",
  "headline": "How to Set Up a CI/CD Pipeline with GitHub Actions",
  "author": {
    "@type": "Person",
    "name": "Alex Rivera"
  },
  "datePublished": "2024-09-15",
  "proficiencyLevel": "Intermediate",
  "dependencies": "Node.js 18+, npm, Git, GitHub account",
  "description": "Step-by-step guide to configuring a CI/CD pipeline using GitHub Actions for a Node.js application.",
  "image": "https://example.com/images/cicd-pipeline.png"
}

Webflow implementation

For Webflow blog or documentation sites, create CMS fields for proficiency level (Option field with Beginner/Intermediate/Advanced/Expert values) and dependencies (Plain Text). Reference these fields in an Embed element on the CMS template page alongside standard Article properties.

Schema HQ maps your CMS fields to TechArticle properties and publishes the JSON-LD to Webflow custom code, ensuring proficiencyLevel and dependencies are included alongside standard article metadata.