Technical SEO Architecture: JSON-LD Schema, Crawlability & Canonicalization
The comprehensive engineering guide to technical SEO: Master Schema.org JSON-LD microdata, implement strict canonical URL rules, optimize robots.txt directives, and build semantic HTML heading structures.
1. Semantic HTML5 & The Heading Hierarchy Rule
<!-- STRICT SEMANTIC OUTLINE RULE:
* 1. Exactly ONE <h1> per page representing the core topic.
* 2. Major sections use <h2>.
* 3. Sub-points inside an <h2> use <h3>; never skip levels!
* 4. Use semantic containers (<header>, <main>, <article>, <aside>, <footer>).
-->
<main>
<article>
<header>
<h1>The Definitive Guide to Technical SEO</h1>
<p>Published on <time datetime="2026-10-23">October 23, 2026</time></p>
</header>
<section aria-labelledby="heading-crawlability">
<h2 id="heading-crawlability">1. Crawler Directives</h2>
<p>Search engines crawl URLs via robots.txt and sitemap.xml...</p>
</section>
</article>
</main>Using ARIA labelledby on sections links container regions to their section headings for crawler and screen reader context.
| Element | SEO Purpose | Common Failure | Copy |
|---|---|---|---|
| <title> | Primary headline in SERPs (50-60 chars) | Keyword stuffing or duplicate titles across pages | |
| <meta name="description"> | Click-through teaser in search snippets | Missing, too long (>160 chars), or uninformative | |
| <link rel="canonical"> | Resolves duplicate URL parameters | Relative paths (MUST be absolute HTTPS URL) | |
| <meta name="robots"> | Page-level index/follow directives | Accidentally leaving noindex on production |
2. Schema.org JSON-LD Structured Data Masterclass
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "TechArticle",
"@id": "https://example.com/hub/technical-seo#article",
"isPartOf": { "@id": "https://example.com/#website" },
"headline": "Technical SEO Architecture & JSON-LD Guide",
"description": "Master Schema.org structured data, canonicalization, and crawl budgets.",
"inLanguage": "en-US",
"datePublished": "2026-10-23T12:00:00Z",
"dateModified": "2026-10-23T15:00:00Z",
"author": {
"@type": "Person",
"name": "Platform Engineering Team"
}
},
{
"@type": "BreadcrumbList",
"@id": "https://example.com/hub/technical-seo#breadcrumb",
"itemListElement": [
{ "@type": "ListItem", "position": 1, "name": "Home", "item": "https://example.com" },
{ "@type": "ListItem", "position": 2, "name": "Hub", "item": "https://example.com/hub" },
{ "@type": "ListItem", "position": 3, "name": "SEO Architecture" }
]
}
]
}
</script>Using @graph connects multiple schemas (Article, Organization, Breadcrumb) into a single cohesive semantic graph.
3. Canonical URL Discipline & Duplicate Content Mitigation
<!-- CRITICAL CANONICAL RULES:
* 1. ALWAYS use the full absolute URL including protocol: https://...
* 2. NEVER use relative paths: <link rel="canonical" href="/seo"> (IGNORABLE by Google!)
* 3. Strip all tracking parameters (?utm_source=..., ?ref=...) from the canonical target.
* 4. Standardize trailing slash conventions across 301 redirects and canonicals.
-->
<link rel="canonical" href="https://mayonlinetools.com/hub/technical-seo-schema-structured-data-guide" />Every indexable page must contain a self-referencing canonical URL pointing to its cleanest canonical address.
4. Robots.txt, Sitemap.xml & Crawl Budget Optimization
# robots.txt
User-agent: *
Allow: /
# Disallow internal search query loops and dynamic user sessions
Disallow: /api/
Disallow: /admin/
Disallow: /*?search=*
Disallow: /*?filter=*
# Explicitly permit Google AdSense crawler
User-agent: Mediapartners-Google
Allow: /
# Canonical sitemap declaration
Sitemap: https://mayonlinetools.com/sitemap.xmlAlways specify the absolute HTTPS URL for the sitemap directive at the bottom of robots.txt.
5. Open Graph & Social Card Engineering
<!-- Open Graph (Facebook, LinkedIn, Discord, Slack) -->
<meta property="og:site_name" content="MayOnlineTools" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://mayonlinetools.com/hub/technical-seo-schema-structured-data-guide" />
<meta property="og:title" content="Technical SEO Architecture & JSON-LD Guide" />
<meta property="og:description" content="Master Schema.org structured data, canonicalization, and crawl budgets." />
<meta property="og:image" content="https://mayonlinetools.com/assets/og-seo.png" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />
<!-- Twitter Cards -->
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:title" content="Technical SEO Architecture & JSON-LD Guide" />
<meta name="twitter:description" content="Master Schema.org structured data, canonicalization, and crawl budgets." />
<meta name="twitter:image" content="https://mayonlinetools.com/assets/og-seo.png" />The standard social share image aspect ratio is 1.91:1 (recommended resolution: 1200x630 pixels).
Related Free Online Tools
Put these techniques into practice immediately with our privacy-first browser utilities:
Generate complete HTML head metadata including Google SEO meta tags, Open Graph cards, and Twitter Cards.
Convert clean Markdown content into semantic, crawlable HTML5 markup with accessible heading hierarchies.
Ensure query strings and URL slugs are properly percent-encoded for crawler compatibility.