Organizations Local Business CafeOrCoffeeShop

Portfolio Page Blueprint — Café / Coffee Shop

Structures your latte art, shop atmosphere, and events hosted so AI can assess your café experience. When someone asks "find a cozy coffee shop with great ambiance" or "cafés that host live music," this page gives AI a structured gallery of what makes your shop special.

What this page needs

A portfolio page is proof of experience. AI uses it to verify that your café offers the atmosphere, craft, and events you claim. Without structured data, AI sees a page of images with no context about what they represent.

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

CafeOrCoffeeShop

name
Non-negotiable. AI cannot cite or recommend an unnamed entity.
url
AI needs a stable URL to route users and attribute recommendations.
telephone
AI won't recommend a local business it can't confirm is reachable. Phone is the primary trust signal for location-based queries.

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 Cafe or Coffee Shop 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. Cafe name
2. Domain
3. Faq answer
4. Faq question
5. Item description
6. Item image
7. Item name
8. Item url
9. Phone number
10. Portfolio page description
11. Portfolio page title

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 Cafe or Coffee Shop 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 this template and replace every YOUR_* placeholder with your own data. Add or remove items from the ItemList to match your actual portfolio.

JSON-LD · Portfolio Page
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "CollectionPage",
      "@id": "https://YOUR_DOMAIN.com/portfolio/",
      "name": "YOUR_PORTFOLIO_PAGE_TITLE",
      "description": "YOUR_PORTFOLIO_PAGE_DESCRIPTION",
      "isPartOf": {
        "@id": "https://YOUR_DOMAIN.com/#website"
      },
      "mainEntity": {
        "@type": "ItemList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "item": {
              "@type": "CreativeWork",
              "name": "YOUR_ITEM_NAME_1",
              "description": "YOUR_ITEM_DESCRIPTION_1",
              "image": "https://YOUR_DOMAIN.com/YOUR_ITEM_IMAGE_1.jpg",
              "url": "https://YOUR_DOMAIN.com/YOUR_ITEM_URL_1/"
            }
          },
          {
            "@type": "ListItem",
            "position": 2,
            "item": {
              "@type": "CreativeWork",
              "name": "YOUR_ITEM_NAME_2",
              "description": "YOUR_ITEM_DESCRIPTION_2",
              "image": "https://YOUR_DOMAIN.com/YOUR_ITEM_IMAGE_2.jpg",
              "url": "https://YOUR_DOMAIN.com/YOUR_ITEM_URL_2/"
            }
          },
          {
            "@type": "ListItem",
            "position": 3,
            "item": {
              "@type": "CreativeWork",
              "name": "YOUR_ITEM_NAME_3",
              "description": "YOUR_ITEM_DESCRIPTION_3",
              "image": "https://YOUR_DOMAIN.com/YOUR_ITEM_IMAGE_3.jpg",
              "url": "https://YOUR_DOMAIN.com/YOUR_ITEM_URL_3/"
            }
          }
        ]
      }
    },
    {
      "@type": "CafeOrCoffeeShop",
      "@id": "https://YOUR_DOMAIN.com/#business",
      "name": "YOUR_CAFE_NAME",
      "url": "https://YOUR_DOMAIN.com",
      "telephone": "YOUR_PHONE_NUMBER"
    },
    {
      "@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",
      "@id": "https://YOUR_DOMAIN.com/portfolio/#faq",
      "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

Should I use CreativeWork or ImageObject for café portfolio items?

CreativeWork is the better choice because it lets you describe the item with a name, description, and image together. ImageObject only describes the photo itself, not the context behind it. AI needs to know this is "latte art from a private tasting event," not just a photo of coffee.

What kinds of portfolio items work best for a café?

Include latte art showcases, interior and atmosphere shots, event setups (live music nights, pop-up markets), seasonal decorations, and behind-the-scenes roasting photos. The goal is to give AI a well-rounded picture of your café experience beyond just the menu.

How many portfolio items should I include in the ItemList?

Include every piece you want AI to know about. There is no practical limit. More items give AI a broader picture of your café — if you host events, create latte art, and design seasonal spaces, show examples of all three so AI can match you to a wider range of queries.

Test your structured data

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

Open Validator →