Organizations › Services › GeneralContractor

Portfolio Blueprint — General Contractor

Your portfolio page showcases completed projects. This blueprint structures each project as a machine-readable entry so AI systems can cite specific builds, renovations, and outcomes when recommending your contracting business.

View Prompt View JSON

What this page needs

The portfolio page is your proof of work. When someone asks AI "show me contractors who have done whole-home renovations" or "who has experience with commercial buildouts," this is the page that provides the evidence. Without structured project data, AI cannot connect your past work to incoming queries.

CollectionPage type. Use CollectionPage as the page type to signal that this is a curated set of items, not a single article or service listing.
CreativeWork entries for each project. Each completed project should be a CreativeWork node with a name, description, image, and dateCreated. This gives AI a structured record of what you built, when, and what it looked like.
Organization reference. Link each project back to your GeneralContractor node using creator or author so AI knows which company did the work.
Project location. Adding contentLocation to each project tells AI where the work was done, reinforcing your geographic expertise.

A portfolio with photos but no structured data is invisible to AI. Structuring each project turns your past work into citable evidence of your capabilities.

Why these fields matter to AI

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

GeneralContractor

name: Non-negotiable. AI cannot cite or recommend an unnamed entity.
url: AI needs a stable URL to attribute recommendations and route users correctly.
logo: Visual identity signal. AI uses logo presence to assess institutional legitimacy before recommending a service.

Use This Prompt to Implement Your Schema

Copy 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 General Contractor 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. Company name
2. Domain
3. Faq answer
4. Faq question
5. Logo
6. Portfolio page description
7. Portfolio page title
8. Project date
9. Project description
10. Project image
11. Project location
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 General Contractor 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

Template — fill in your values

Copy the template below and replace every YOUR_* value with your own data. Add or remove CreativeWork 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"
      },
      "breadcrumb": {
        "@id": "https://YOUR_DOMAIN.com/portfolio/#breadcrumb"
      },
      "mainEntity": {
        "@type": "ItemList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "item": {
              "@id": "https://YOUR_DOMAIN.com/portfolio/#project-1"
            }
          },
          {
            "@type": "ListItem",
            "position": 2,
            "item": {
              "@id": "https://YOUR_DOMAIN.com/portfolio/#project-2"
            }
          },
          {
            "@type": "ListItem",
            "position": 3,
            "item": {
              "@id": "https://YOUR_DOMAIN.com/portfolio/#project-3"
            }
          }
        ]
      }
    },
    {
      "@type": "CreativeWork",
      "@id": "https://YOUR_DOMAIN.com/portfolio/#project-1",
      "name": "YOUR_PROJECT_NAME_1",
      "description": "YOUR_PROJECT_DESCRIPTION_1",
      "image": "https://YOUR_DOMAIN.com/YOUR_PROJECT_IMAGE_1.jpg",
      "dateCreated": "YOUR_PROJECT_DATE_1",
      "creator": {
        "@id": "https://YOUR_DOMAIN.com/#organization"
      },
      "contentLocation": {
        "@type": "Place",
        "name": "YOUR_PROJECT_LOCATION_1"
      }
    },
    {
      "@type": "CreativeWork",
      "@id": "https://YOUR_DOMAIN.com/portfolio/#project-2",
      "name": "YOUR_PROJECT_NAME_2",
      "description": "YOUR_PROJECT_DESCRIPTION_2",
      "image": "https://YOUR_DOMAIN.com/YOUR_PROJECT_IMAGE_2.jpg",
      "dateCreated": "YOUR_PROJECT_DATE_2",
      "creator": {
        "@id": "https://YOUR_DOMAIN.com/#organization"
      },
      "contentLocation": {
        "@type": "Place",
        "name": "YOUR_PROJECT_LOCATION_2"
      }
    },
    {
      "@type": "CreativeWork",
      "@id": "https://YOUR_DOMAIN.com/portfolio/#project-3",
      "name": "YOUR_PROJECT_NAME_3",
      "description": "YOUR_PROJECT_DESCRIPTION_3",
      "image": "https://YOUR_DOMAIN.com/YOUR_PROJECT_IMAGE_3.jpg",
      "dateCreated": "YOUR_PROJECT_DATE_3",
      "creator": {
        "@id": "https://YOUR_DOMAIN.com/#organization"
      },
      "contentLocation": {
        "@type": "Place",
        "name": "YOUR_PROJECT_LOCATION_3"
      }
    },
    {
      "@type": "GeneralContractor",
      "@id": "https://YOUR_DOMAIN.com/#organization",
      "name": "YOUR_COMPANY_NAME",
      "url": "https://YOUR_DOMAIN.com",
      "logo": "https://YOUR_DOMAIN.com/YOUR_LOGO.png"
    },
    {
      "@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"
          }
        }
      ]
    }
  ]
}

Frequently asked questions

Why use CreativeWork instead of a more specific type like Project?

Schema.org does not have a dedicated Project type for construction work. CreativeWork is the best general-purpose type for portfolio entries because it supports name, description, image, dateCreated, and creator — everything AI needs to understand a completed project. The contentLocation field adds geographic context.

How many portfolio projects should I include?

Include every project you want AI to know about. There is no practical limit, but each entry should have a clear name, description, and image. Quality matters more than quantity — three well-described projects with photos are more useful to AI than twenty entries with just a title.

Should I include project cost or budget information?

Only if you are comfortable sharing it publicly. You can add a material or custom property, but there is no standard Schema.org field for project cost on CreativeWork. If budget transparency is part of your marketing, include it in the description. Otherwise, focus on scope, location, and outcome.