Your portfolio page is the proof layer. It shows AI what you have actually done, not just what you say you can do. This blueprint structures your past projects with descriptions, images, and client context so AI can assess your capabilities and recommend you for similar work.
When someone asks AI "who has experience with enterprise migrations" or "find a firm that has done nonprofit branding," the portfolio page is where AI finds the evidence. Without structured data, AI has to guess from image alt text and paragraph copy. With it, every project becomes a searchable, citable data point.
CollectionPage tells AI this is a curated set of related items, not a generic content page. It sets the expectation that each item in the collection represents a distinct project.CreativeWork node with its own name, description, image, and url. This gives AI structured access to every project individually.about field on each CreativeWork can reference the industry or client type, helping AI match your past work to a prospect's query.image field on each project gives AI a visual reference it can surface in image-rich results or use to verify the project is real.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 Professional Service 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. Domain 2. Faq answer 3. Faq question 4. Organization name 5. Portfolio page description 6. Portfolio page title 7. 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 Professional Service 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 CreativeWork nodes to match the number of portfolio pieces you showcase.
{
"@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/#organization"
},
"breadcrumb": {
"@id": "https://YOUR_DOMAIN.com/portfolio/#breadcrumb"
},
"mainEntity": {
"@type": "ItemList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"item": {
"@type": "CreativeWork",
"name": "YOUR_PROJECT_1_NAME",
"description": "YOUR_PROJECT_1_DESCRIPTION",
"image": "https://YOUR_DOMAIN.com/YOUR_PROJECT_1_IMAGE.jpg",
"url": "https://YOUR_DOMAIN.com/portfolio/YOUR_PROJECT_1_SLUG/",
"about": "YOUR_PROJECT_1_INDUSTRY_OR_CLIENT_TYPE"
}
},
{
"@type": "ListItem",
"position": 2,
"item": {
"@type": "CreativeWork",
"name": "YOUR_PROJECT_2_NAME",
"description": "YOUR_PROJECT_2_DESCRIPTION",
"image": "https://YOUR_DOMAIN.com/YOUR_PROJECT_2_IMAGE.jpg",
"url": "https://YOUR_DOMAIN.com/portfolio/YOUR_PROJECT_2_SLUG/",
"about": "YOUR_PROJECT_2_INDUSTRY_OR_CLIENT_TYPE"
}
},
{
"@type": "ListItem",
"position": 3,
"item": {
"@type": "CreativeWork",
"name": "YOUR_PROJECT_3_NAME",
"description": "YOUR_PROJECT_3_DESCRIPTION",
"image": "https://YOUR_DOMAIN.com/YOUR_PROJECT_3_IMAGE.jpg",
"url": "https://YOUR_DOMAIN.com/portfolio/YOUR_PROJECT_3_SLUG/",
"about": "YOUR_PROJECT_3_INDUSTRY_OR_CLIENT_TYPE"
}
}
]
}
},
{
"@type": "Organization",
"@id": "https://YOUR_DOMAIN.com/#organization",
"name": "YOUR_ORGANIZATION_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"
}
}
]
}
]
}
CreativeWork is the right choice for most professional service portfolios because it covers a wide range of deliverables — websites, reports, designs, campaigns, and more. If every item is the same type (for example, all software projects), you could use a more specific subtype like SoftwareApplication, but CreativeWork works universally and AI recognizes it without ambiguity.
Ideally, yes. A dedicated page per project gives AI more content to index — the full description, results, client context, and images. If you only have a single portfolio gallery page, you can still use this blueprint with anchor links or omit the individual url fields. But dedicated pages significantly increase your chances of appearing in specific project-type queries.
Use the about field to name the industry or project type, not the client. For example, "Healthcare SaaS redesign" or "Nonprofit brand identity" tells AI what kind of work you did, which is what matters for matching future queries. Client names only help if the client is a well-known entity that AI already recognizes.