TechArticle & API Documentation Schema (JSON-LD)
Specialized structured data for technical manuals, API guides, SDK documentation, and programming tutorials.
Displayed below main page header or above the tool container. • Zero CLS Container
Production JSON-LD Code Block
Embed this structured data block directly into your HTML <head> or framework layout template.
{
"@context": "https://schema.org",
"@type": "TechArticle",
"headline": "Configuring Robots.txt AI Scraper Exclusions in Next.js 15 App Router",
"description": "Step-by-step developer guide on implementing RFC 9309 robots.txt rules to block LLM scrapers without degrading SEO crawl budget.",
"proficiencyLevel": "Expert",
"dependencies": "Next.js 15+, TypeScript 5+, Node.js 20+",
"datePublished": "2026-09-28T14:00:00+00:00",
"dateModified": "2026-10-02T10:00:00+00:00",
"author": {
"@type": "Person",
"name": "Amr Gharz",
"jobTitle": "Staff Software Engineer"
},
"publisher": {
"@type": "Organization",
"name": "OmniSEO Tools",
"url": "https://omniseotools.com"
}
}Typed Properties Specification (6 Fields)
Key Schema.org properties and sub-objects required to qualify for rich snippet treatment in Google Search.
| Property | Expected Type | Status | Description & Example |
|---|---|---|---|
| headline | Text | Required | Clear, descriptive title of technical documentation. e.g. Configuring Robots.txt AI Scraper Exclusions |
| proficiencyLevel | Text | Recommended | Target audience technical level (Beginner, Intermediate, Expert). e.g. Expert |
| dependencies | Text | Recommended | Prerequisite software, compilers, libraries, or frameworks. e.g. Next.js 15+, TypeScript 5+ |
| datePublished | DateTime | Required | Initial documentation release timestamp. e.g. 2026-09-28T14:00:00+00:00 |
| dateModified | DateTime | Required | Last code patch or verification timestamp. e.g. 2026-10-02T10:00:00+00:00 |
| author | Person | Required | Engineer or technical writer responsible for the specification. e.g. { "@type": "Person", "name": "..." } |
Google Search Console Pitfalls & Critical Warnings
Avoid these 3 common validation traps, parser errors, and algorithmic policy penalties when deploying TechArticle schema.
Omitting Framework Version Dependencies
Failing to state target runtime versions causes outdated code to frustrate developers.
Populate the dependencies property with exact framework versions.
Mixing TechArticle with HowTo Steps Improperly
Embedding unstructured text in HowTo inside TechArticle without proper step nodes leads to parse errors.
Keep TechArticle for technical documentation and use HowTo for consumer step guides.
Stale DateModified on Breaking API Changes
Not updating dateModified after updating deprecated syntax causes search engines to rank outdated code snippets.
Automate dateModified updates via CI/CD git commit hooks.
Recommended Implementation Scenarios
Related Schema Blueprints
Explore complementary structured data blueprints across the Editorial cluster.
Displayed below main page header or above the tool container. • Zero CLS Container