We use cookies for analytics and to serve ads. Accept to enable Google Analytics and AdSense. You can decline to stay opt-out.
Migration guides for SaaS products with HowTo steps, supporting TechArticle detail, FAQs, and breadcrumb navigation.
Captures the primary step-by-step migration process.
Provides technical context, prerequisites, and deeper explanations.
Answers migration timing, rollback, and support questions.
Provides navigation context to the migration guide.
Ensure every applicable required property is present in your implementation. Nested props reference their parent objects (for example, `offers.priceCurrency`).
Paste as a single script tag. Keep product details, offer data, shipping/returns, and FAQ answers in sync with the page.
[
{
"@context": "https://schema.org",
"@type": "HowTo",
"@id": "https://www.example.com/migrate-to-v2#howto",
"name": "Migrate from v1 to v2",
"description": "Step-by-step guide to migrate from the legacy app to v2 with zero downtime.",
"totalTime": "PT2H",
"tool": [
{ "@type": "HowToTool", "name": "CLI v2" }
],
"supply": [
{ "@type": "HowToSupply", "name": "API credentials" }
],
"step": [
{
"@type": "HowToStep",
"name": "Back up data",
"text": "Export your data from v1 using the backup CLI command and store it securely."
},
{
"@type": "HowToStep",
"name": "Install v2 CLI",
"text": "Download and install the v2 CLI. Verify with cli --version."
},
{
"@type": "HowToStep",
"name": "Run migration",
"text": "Execute the migration script with your API key. Monitor logs for errors."
}
]
},
{
"@context": "https://schema.org",
"@type": "TechArticle",
"@id": "https://www.example.com/migrate-to-v2#article",
"headline": "Migration Guide: v1 to v2",
"description": "Technical migration notes, prerequisites, and rollback steps for moving to v2.",
"url": "https://www.example.com/migrate-to-v2",
"dateModified": "2025-03-15",
"proficiencyLevel": "Intermediate",
"author": {
"@type": "Person",
"name": "Alex Kim"
}
},
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "Will there be downtime?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Zero-downtime is supported when you run the migration with blue/green cutover as shown in the guide."
}
},
{
"@type": "Question",
"name": "How do I roll back?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Restore from your v1 backup and switch traffic back. Keep DNS TTL low during migration."
}
},
{
"@type": "Question",
"name": "Where do I get help?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Use the support form or live chat linked on this page. Include your migration logs for faster assistance."
}
}
]
},
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [
{ "@type": "ListItem", "position": 1, "name": "Home", "item": "https://www.example.com" },
{ "@type": "ListItem", "position": 2, "name": "Docs", "item": "https://www.example.com/docs" },
{ "@type": "ListItem", "position": 3, "name": "Migration", "item": "https://www.example.com/migrate-to-v2" }
]
}
]Yes. Keep them in the page body; the TechArticle object can link to the same URL as the guide.
Yes. HowTo captures the steps; TechArticle provides supporting technical context and authority signals.