Your case studies page tells the full story of completed plumbing jobs — the problem, the approach, and the result. This blueprint structures those detailed narratives as a collection so AI can understand not just what you do, but how you solve complex plumbing problems.
Case studies go deeper than portfolio entries. While a portfolio shows what you built, a case study explains the diagnosis, the solution, and the outcome. AI uses this narrative depth to match your business to complex queries like "plumber who has handled polybutylene repipes" or "experienced with commercial backflow prevention." The more detail you structure, the more specific queries you can win.
CollectionPage with a mainEntity of type ItemList organizes your case studies into an indexed collection that AI can browse and filter.CreativeWork entry should have a thorough description covering the problem, solution, and result. AI reads these descriptions to build a picture of your problem-solving capabilities.author reference on each case study ties the work back to your Plumber node, connecting the expertise demonstrated in the narrative to your business identity.datePublished on each case study tells AI how current your experience is. Recent case studies carry more weight than outdated ones for AI recommendations.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 Plumber 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. Business name 2. Case studies page description 3. Case studies page title 4. Case study date 5. Case study description 6. Case study image 7. Case study title 8. Domain 9. Faq answer 10. Faq question 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 Plumber 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 CreativeWork entries to match your actual case studies. 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"
},
"mainEntity": {
"@type": "ItemList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"item": {
"@type": "CreativeWork",
"name": "YOUR_CASE_STUDY_TITLE_1",
"description": "YOUR_CASE_STUDY_DESCRIPTION_1",
"image": "https://YOUR_DOMAIN.com/YOUR_CASE_STUDY_IMAGE_1.jpg",
"datePublished": "YOUR_CASE_STUDY_DATE_1",
"author": {
"@id": "https://YOUR_DOMAIN.com/#business"
}
}
},
{
"@type": "ListItem",
"position": 2,
"item": {
"@type": "CreativeWork",
"name": "YOUR_CASE_STUDY_TITLE_2",
"description": "YOUR_CASE_STUDY_DESCRIPTION_2",
"image": "https://YOUR_DOMAIN.com/YOUR_CASE_STUDY_IMAGE_2.jpg",
"datePublished": "YOUR_CASE_STUDY_DATE_2",
"author": {
"@id": "https://YOUR_DOMAIN.com/#business"
}
}
},
{
"@type": "ListItem",
"position": 3,
"item": {
"@type": "CreativeWork",
"name": "YOUR_CASE_STUDY_TITLE_3",
"description": "YOUR_CASE_STUDY_DESCRIPTION_3",
"image": "https://YOUR_DOMAIN.com/YOUR_CASE_STUDY_IMAGE_3.jpg",
"datePublished": "YOUR_CASE_STUDY_DATE_3",
"author": {
"@id": "https://YOUR_DOMAIN.com/#business"
}
}
}
]
},
"breadcrumb": {
"@id": "https://YOUR_DOMAIN.com/case-studies/#breadcrumb"
}
},
{
"@type": "Plumber",
"@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"
}
}
]
}
]
}
A portfolio entry is a brief showcase — project name, photo, and a short description. A case study is a narrative that covers the problem the customer faced, the diagnostic process, the solution you implemented, and the outcome. AI treats case studies as deeper evidence of expertise. If someone asks "find a plumber who has solved slab leak problems," a case study about a slab leak repair gives AI a much richer answer than a portfolio thumbnail.
Aim for two to four sentences that cover the problem, solution, and result. For example: "Homeowner reported low water pressure throughout a 1960s rambler. Camera inspection revealed corroded galvanized pipes throughout the supply lines. We completed a full copper repipe in three days with minimal drywall removal. Water pressure increased from 25 PSI to 55 PSI." AI reads this level of detail to match you to specific problem queries.
Customer quotes belong in a Review schema on a separate testimonials or reviews page, not inside the case study CreativeWork. The case study description should be your factual account of the work performed. If you want to reference customer satisfaction, state it factually in the description rather than embedding a quote. AI treats CreativeWork descriptions as authored content, not third-party reviews.