Your portfolio page showcases completed projects with photos, descriptions, and dates. This blueprint structures each project as a machine-readable entry so AI systems can surface real examples of your work when someone asks for contractors who have done similar jobs.
A portfolio page is proof of work. AI systems use it to verify that a company has actually completed the type of projects it claims to offer. Without structured data, photos and descriptions are invisible to AI — it cannot distinguish a gallery of completed kitchens from a stock photo collection.
CollectionPage node tells AI this page contains a curated set of items — in this case, completed construction projects — rather than a single article or service listing.CreativeWork with its own name, description, image, and dateCreated. This gives AI a structured record of every job you have completed.ImageObject entries with contentUrl, name, and description make your before-and-after photos indexable and attributable.HomeAndConstructionBusiness via @id ties the work directly to your company identity.Structured portfolio data is what separates a company AI can verify from one it has to take at face value.
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 Portfolio 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. Domain 3. Faq answer 4. Faq question 5. Image alt text 6. Image caption 7. Portfolio page description 8. Portfolio page title 9. Project date 10. Project description 11. Project image 12. Project name 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 Portfolio" - 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 the number of projects in your portfolio.
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "CollectionPage",
"@id": "https://YOUR_DOMAIN.com/portfolio/",
"name": "YOUR_PORTFOLIO_PAGE_TITLE",
"description": "YOUR_PORTFOLIO_PAGE_DESCRIPTION",
"url": "https://YOUR_DOMAIN.com/portfolio/",
"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_PROJECT_NAME_1",
"description": "YOUR_PROJECT_DESCRIPTION_1",
"image": {
"@type": "ImageObject",
"contentUrl": "https://YOUR_DOMAIN.com/YOUR_PROJECT_IMAGE_1.jpg",
"name": "YOUR_IMAGE_CAPTION_1",
"description": "YOUR_IMAGE_ALT_TEXT_1"
},
"dateCreated": "YOUR_PROJECT_DATE_1"
}
},
{
"@type": "ListItem",
"position": 2,
"item": {
"@type": "CreativeWork",
"name": "YOUR_PROJECT_NAME_2",
"description": "YOUR_PROJECT_DESCRIPTION_2",
"image": {
"@type": "ImageObject",
"contentUrl": "https://YOUR_DOMAIN.com/YOUR_PROJECT_IMAGE_2.jpg",
"name": "YOUR_IMAGE_CAPTION_2",
"description": "YOUR_IMAGE_ALT_TEXT_2"
},
"dateCreated": "YOUR_PROJECT_DATE_2"
}
},
{
"@type": "ListItem",
"position": 3,
"item": {
"@type": "CreativeWork",
"name": "YOUR_PROJECT_NAME_3",
"description": "YOUR_PROJECT_DESCRIPTION_3",
"image": {
"@type": "ImageObject",
"contentUrl": "https://YOUR_DOMAIN.com/YOUR_PROJECT_IMAGE_3.jpg",
"name": "YOUR_IMAGE_CAPTION_3",
"description": "YOUR_IMAGE_ALT_TEXT_3"
},
"dateCreated": "YOUR_PROJECT_DATE_3"
}
}
]
},
"breadcrumb": {
"@id": "https://YOUR_DOMAIN.com/portfolio/#breadcrumb"
}
},
{
"@type": "HomeAndConstructionBusiness",
"@id": "https://YOUR_DOMAIN.com/#business",
"name": "YOUR_BUSINESS_NAME",
"url": "https://YOUR_DOMAIN.com"
},
{
"@type": "BreadcrumbList",
"@id": "https://YOUR_DOMAIN.com/portfolio/#breadcrumb",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Home",
"item": "https://YOUR_DOMAIN.com/"
},
{
"@type": "ListItem",
"position": 2,
"name": "Portfolio",
"item": "https://YOUR_DOMAIN.com/portfolio/"
}
]
},
{
"@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"
}
}
]
}
]
}
Use CreativeWork as the main type for each project, with an ImageObject nested inside the image field. The CreativeWork represents the project itself — the name, description, and completion date. The ImageObject represents the photo of that project. This two-level structure lets AI understand both the work you did and the visual evidence of it.
Include every project that appears on the portfolio page. There is no practical upper limit. AI uses these entries to gauge the breadth and volume of your work, so more entries with good descriptions give AI more data to work with when deciding whether to recommend you for a specific type of project.
Yes. Change the image field from a single ImageObject to an array of ImageObject entries. Give each image a descriptive name like "Before — kitchen" and "After — kitchen" so AI can distinguish the two and understand the transformation.