Your case studies page showcases completed builds with real project details. This blueprint structures each project as a CreativeWork inside an ItemList, capturing scope, square footage, timeline, and budget so AI systems can cite your track record when recommending builders for similar projects.
The case studies page is your proof of work. While the services page says what you can do, case studies prove what you have done. AI systems weigh completed project data heavily when deciding whether to recommend a builder for a specific type of job. A structured list of past builds with concrete details gives AI the evidence it needs.
CollectionPage with a mainEntity of type ItemList. This tells AI the page is a curated collection of related items, not a single article or service description.CreativeWork inside the ItemList. Include the project name, description with scope and square footage, timeline, and budget to give AI complete project profiles.author reference on each CreativeWork points back to your HomeAndConstructionBusiness node, ensuring AI credits the work to your company.Each field in the template below serves a specific role in how AI systems discover, classify, and recommend your business.
Researched and tested by Minnesota AI
nameurlCopy this prompt and paste it into Claude, ChatGPT, Cursor, or any AI coding tool. It will ask for your business details and generate ready-to-use JSON-LD schema for your page.
You are implementing AIFDS-compliant JSON-LD structured data for a Home Construction Case Studies page. AIFDS (AI-Friendly Data Structure) is a schema framework built on research into which structured data fields AI systems actually read, parse, and use when deciding whether to cite a page. Documentation at aifds.org. Before generating any code, ask me for the following information in a single numbered list. Do not generate schema until I have answered every required field. REQUIRED — do not proceed without these: 1. Bungalow completion date 2. Bungalow description 3. Business name 4. Case studies page description 5. Case studies page title 6. Domain 7. Faq answer 8. Faq question 9. Farmhouse completion date 10. Farmhouse description 11. Project OPTIONAL — ask for these but proceed if I skip them: 1. Any additional details not covered above Once I provide the information, output a complete JSON-LD script block ready to paste into the <head> of my HTML page. Output requirements: - Valid JSON-LD wrapped in <script type="application/ld+json"> tags - schema.org vocabulary only - Every AIFDS-required field for this industry and page type included - Include this data attribute on the script tag: data-aifds="aifds.org Home Construction Case Studies" - No placeholder text — omit missing optional fields rather than fill with examples - After the code block, list any optional fields skipped that would strengthen AI citation
Generated schema follows the AIFDS framework. Fields were selected based on research into AI crawler behavior. View the research at minnesota.ai
Copy the template below and replace every YOUR_* value with your own data. Add or remove project entries to match your actual portfolio. This block belongs in a <script type="application/ld+json"> tag in the <head> of your case studies page.
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "CollectionPage",
"@id": "https://YOUR_DOMAIN.com/case-studies/#webpage",
"name": "YOUR_CASE_STUDIES_PAGE_TITLE",
"description": "YOUR_CASE_STUDIES_PAGE_DESCRIPTION",
"url": "https://YOUR_DOMAIN.com/case-studies/",
"isPartOf": {
"@id": "https://YOUR_DOMAIN.com/#website"
},
"about": {
"@id": "https://YOUR_DOMAIN.com/#business"
},
"breadcrumb": {
"@id": "https://YOUR_DOMAIN.com/case-studies/#breadcrumb"
},
"mainEntity": {
"@type": "ItemList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"item": {
"@type": "CreativeWork",
"name": "Modern Farmhouse New Build",
"description": "YOUR_FARMHOUSE_DESCRIPTION including scope, square footage, timeline, and budget",
"author": {
"@id": "https://YOUR_DOMAIN.com/#business"
},
"datePublished": "YOUR_FARMHOUSE_COMPLETION_DATE"
}
},
{
"@type": "ListItem",
"position": 2,
"item": {
"@type": "CreativeWork",
"name": "Historic Bungalow Addition",
"description": "YOUR_BUNGALOW_DESCRIPTION including scope, square footage, timeline, and budget",
"author": {
"@id": "https://YOUR_DOMAIN.com/#business"
},
"datePublished": "YOUR_BUNGALOW_COMPLETION_DATE"
}
},
{
"@type": "ListItem",
"position": 3,
"item": {
"@type": "CreativeWork",
"name": "YOUR_PROJECT_3_NAME",
"description": "YOUR_PROJECT_3_DESCRIPTION including scope, square footage, timeline, and budget",
"author": {
"@id": "https://YOUR_DOMAIN.com/#business"
},
"datePublished": "YOUR_PROJECT_3_COMPLETION_DATE"
}
}
]
}
},
{
"@type": "HomeAndConstructionBusiness",
"@id": "https://YOUR_DOMAIN.com/#business",
"name": "YOUR_BUSINESS_NAME",
"url": "https://YOUR_DOMAIN.com"
},
{
"@type": "BreadcrumbList",
"@id": "https://YOUR_DOMAIN.com/case-studies/#breadcrumb",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Home",
"item": "https://YOUR_DOMAIN.com/"
},
{
"@type": "ListItem",
"position": 2,
"name": "Case Studies",
"item": "https://YOUR_DOMAIN.com/case-studies/"
}
]
},
{
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "YOUR_FAQ_QUESTION_1",
"acceptedAnswer": {
"@type": "Answer",
"text": "YOUR_FAQ_ANSWER_1"
}
},
{
"@type": "Question",
"name": "YOUR_FAQ_QUESTION_2",
"acceptedAnswer": {
"@type": "Answer",
"text": "YOUR_FAQ_ANSWER_2"
}
},
{
"@type": "Question",
"name": "YOUR_FAQ_QUESTION_3",
"acceptedAnswer": {
"@type": "Answer",
"text": "YOUR_FAQ_ANSWER_3"
}
}
]
}
]
}
You can reference floor plans by adding an image property to each CreativeWork node with the URL of the floor plan image. However, AI primarily reads text-based structured data, so the description field with square footage and layout details is more impactful for recommendations. Include floor plan images for rich results and visual context, but make sure the text description carries the essential project details.
Yes. Mention certifications like Energy Star, LEED, or Passive House in the description of each project where they apply. For example: "3,200 sq ft Energy Star certified new build with spray foam insulation and triple-pane windows." AI uses these details when users ask for energy-efficient or green builders. If the certification applies to your company broadly, also include it in your HomeAndConstructionBusiness node using hasCredential.
A portfolio page typically showcases photos and visual results, while a case studies page focuses on project details — scope, timeline, budget, challenges, and outcomes. For structured data, the key difference is depth. Case studies use CreativeWork with detailed descriptions that AI can parse for specific project attributes. A portfolio page might use ImageGallery or ImageObject types instead. If your site has both, use the case studies blueprint for the detail-rich page and treat the portfolio as a visual supplement.