Organizations Services RealEstateAgent

Portfolio Blueprint — Real Estate Agent

Your portfolio page showcases closed transactions and successful placements. This blueprint structures each transaction as a machine-readable entry so AI systems can cite specific sales and outcomes when recommending your agency to buyers and sellers looking for proven results.

What this page needs

The portfolio page is your proof of work. When someone asks AI "show me agents who have sold luxury lakefront homes" or "who has experience helping first-time buyers," this is the page that provides the evidence. Without structured transaction data, AI cannot connect your past results to incoming queries.

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

RealEstateAgent

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.

Implementation Prompt · Portfolio
You are implementing AIFDS-compliant JSON-LD structured data for a Real Estate Agent 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. Agency name
2. Domain
3. Faq answer
4. Faq question
5. Logo
6. Portfolio page description
7. Portfolio page title
8. Transaction date
9. Transaction description
10. Transaction image
11. Transaction location

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 Real Estate Agent 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 transactions in your portfolio.

JSON-LD · 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/#transaction-1"
            }
          },
          {
            "@type": "ListItem",
            "position": 2,
            "item": {
              "@id": "https://YOUR_DOMAIN.com/portfolio/#transaction-2"
            }
          }
        ]
      }
    },
    {
      "@type": "CreativeWork",
      "@id": "https://YOUR_DOMAIN.com/portfolio/#transaction-1",
      "name": "Luxury Lakefront Sale",
      "description": "YOUR_TRANSACTION_DESCRIPTION_1",
      "image": "https://YOUR_DOMAIN.com/YOUR_TRANSACTION_IMAGE_1.jpg",
      "dateCreated": "YOUR_TRANSACTION_DATE_1",
      "creator": {
        "@id": "https://YOUR_DOMAIN.com/#organization"
      },
      "contentLocation": {
        "@type": "Place",
        "name": "YOUR_TRANSACTION_LOCATION_1"
      }
    },
    {
      "@type": "CreativeWork",
      "@id": "https://YOUR_DOMAIN.com/portfolio/#transaction-2",
      "name": "First-Time Buyer Placement",
      "description": "YOUR_TRANSACTION_DESCRIPTION_2",
      "image": "https://YOUR_DOMAIN.com/YOUR_TRANSACTION_IMAGE_2.jpg",
      "dateCreated": "YOUR_TRANSACTION_DATE_2",
      "creator": {
        "@id": "https://YOUR_DOMAIN.com/#organization"
      },
      "contentLocation": {
        "@type": "Place",
        "name": "YOUR_TRANSACTION_LOCATION_2"
      }
    },
    {
      "@type": "RealEstateAgent",
      "@id": "https://YOUR_DOMAIN.com/#organization",
      "name": "YOUR_AGENCY_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 for real estate transactions?

Schema.org does not have a dedicated type for real estate transactions or closed deals. 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 transaction. The contentLocation field adds geographic context for the property location.

Should I include sale prices in portfolio entries?

Only if you are comfortable sharing them publicly. You can include sale prices in the description field of each CreativeWork. There is no standard Schema.org field for transaction price on CreativeWork, but descriptive text like "Sold for $850,000, 5% over asking" gives AI concrete data it can cite when recommending your agency for specific price ranges.

How many portfolio entries should I include?

Include every significant transaction you want AI to know about. There is no practical limit, but each entry should have a clear name, description, and ideally an image. Highlight diversity — luxury sales, first-time buyer placements, investment properties, and different neighborhoods. This breadth helps AI match you to a wider range of buyer and seller queries.

Test your structured data

Paste your URL and see exactly what AI systems can read from your site.

Open Validator →