Content & Media

Content & Media Blueprint

If you publish content, AI needs to understand your publication identity, editorial scope, authorship, and content catalog. The Content family covers four media organization types: Blogger, News Outlet, Publisher, and Media Company, each with page-level blueprints.

What AI needs from content sites

When AI evaluates an article as a source, the current blueprint expects these signals:

Without those fields, an article may still be crawled, but it becomes much harder for AI systems to cite it accurately.

What's in this blueprint

This page covers the core schema nodes shared across all Content family types. Each media organization type (Blogger, News Outlet, Publisher, Media Company) has its own page-level blueprints that build on these foundations.

Article

The article node centers the implementation: @type, headline, description, datePublished, dateModified, author, publisher, url, image, and mainEntityOfPage.

Person

The author node should expose name, url, and at least one sameAs profile so AI can verify the author exists.

Organization

The publisher node carries name, url, and conditional logo and sameAs fields depending on the type of publication.

WebSite

The root site node anchors the article back to the domain using @id, name, and url.

WebPage

Every article page should expose its own @id plus references to the site and breadcrumb graph using isPartOf and breadcrumb.

FAQPage

Optional but useful when the article already contains visible Q&A that should be exposed in a machine-readable way.

BreadcrumbList

The section path that tells AI where the article lives in the publication hierarchy.

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

Person

name
Non-negotiable for authorship attribution. AI cannot cite a named author without this.
url
AI verifies real authors exist through linkable profiles. Without a URL the Person node is an unverifiable claim.
sameAs
AI cross-references the author against external sources to build entity confidence. One link minimum.

Organization

name
AI uses publisher name for source attribution when citing the article.
url
Confirms the organization maps to an accessible domain.
logoconditional
Required for Google News eligibility. Signals institutional legitimacy to AI systems.Required for news publications and Google News eligibility. If this is a personal blog or solo creator site, this field is not applicable.
sameAsconditional
Helps AI confirm the organization is real and has presence outside its own domain.If your Organization is defined on a separate domain and referenced here by @id, sameAs belongs in the full entity definition on that domain.

WebSite

@id
All other schema nodes reference this ID. Without it the graph is disconnected.

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 · Blueprint
You are implementing AIFDS-compliant JSON-LD structured data for a Content Blueprint 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. Article description
2. Article title
3. Author name
4. Company
5. Content type
6. Domain
7. Featured image
8. Github
9. Linkedin
10. Logo
11. Post slug
12. Publisher name
13. Section name
14. Section slug
15. Short summary answer
16. Site name

OPTIONAL — ask for these but proceed if I skip them:
1. sameAs

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 Content Blueprint"
- 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. Keep YOUR_CONTENT_TYPE accurate, and remove the optional publisher fields only if they genuinely do not apply.

JSON-LD · Template
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "YOUR_CONTENT_TYPE",
      "@id": "https://YOUR_DOMAIN.com/YOUR_POST_SLUG/#article",
      "headline": "YOUR_ARTICLE_TITLE",
      "description": "YOUR_ARTICLE_DESCRIPTION",
      "datePublished": "YYYY-MM-DD",
      "dateModified": "YYYY-MM-DD",
      "author": {
        "@id": "https://YOUR_DOMAIN.com/#author"
      },
      "publisher": {
        "@id": "https://YOUR_DOMAIN.com/#organization"
      },
      "url": "https://YOUR_DOMAIN.com/YOUR_POST_SLUG/",
      "image": "https://YOUR_DOMAIN.com/YOUR_FEATURED_IMAGE.jpg",
      "mainEntityOfPage": {
        "@id": "https://YOUR_DOMAIN.com/YOUR_POST_SLUG/"
      }
    },
    {
      "@type": "Person",
      "@id": "https://YOUR_DOMAIN.com/#author",
      "name": "YOUR_AUTHOR_NAME",
      "url": "https://YOUR_DOMAIN.com/about/",
      "sameAs": [
        "https://www.linkedin.com/in/YOUR_LINKEDIN",
        "https://github.com/YOUR_GITHUB"
      ]
    },
    {
      "@type": "Organization",
      "@id": "https://YOUR_DOMAIN.com/#organization",
      "name": "YOUR_PUBLISHER_NAME",
      "url": "https://YOUR_DOMAIN.com",
      "logo": "https://YOUR_DOMAIN.com/YOUR_LOGO.png",
      "sameAs": [
        "https://www.linkedin.com/company/YOUR_COMPANY"
      ]
    },
    {
      "@type": "WebSite",
      "@id": "https://YOUR_DOMAIN.com/#website",
      "name": "YOUR_SITE_NAME",
      "url": "https://YOUR_DOMAIN.com"
    },
    {
      "@type": "WebPage",
      "@id": "https://YOUR_DOMAIN.com/YOUR_POST_SLUG/",
      "isPartOf": {
        "@id": "https://YOUR_DOMAIN.com/#website"
      },
      "breadcrumb": {
        "@id": "https://YOUR_DOMAIN.com/YOUR_POST_SLUG/#breadcrumb"
      }
    },
    {
      "@type": "FAQPage",
      "@id": "https://YOUR_DOMAIN.com/YOUR_POST_SLUG/#faq",
      "mainEntity": [
        {
          "@type": "Question",
          "name": "WHAT_IS_THE_MAIN_TAKEAWAY",
          "acceptedAnswer": {
            "@type": "Answer",
            "text": "YOUR_SHORT_SUMMARY_ANSWER"
          }
        }
      ]
    },
    {
      "@type": "BreadcrumbList",
      "@id": "https://YOUR_DOMAIN.com/YOUR_POST_SLUG/#breadcrumb",
      "itemListElement": [
        {
          "@type": "ListItem",
          "position": 1,
          "name": "Home",
          "item": "https://YOUR_DOMAIN.com/"
        },
        {
          "@type": "ListItem",
          "position": 2,
          "name": "YOUR_SECTION_NAME",
          "item": "https://YOUR_DOMAIN.com/YOUR_SECTION_SLUG/"
        },
        {
          "@type": "ListItem",
          "position": 3,
          "name": "YOUR_ARTICLE_TITLE",
          "item": "https://YOUR_DOMAIN.com/YOUR_POST_SLUG/"
        }
      ]
    }
  ]
}

Frequently asked questions

Should I use Article, BlogPosting, or NewsArticle?

Use the most specific type that matches the page. NewsArticle is for newsroom reporting, BlogPosting is for blog-style editorial content, and Article is the general fallback.

Does the headline need to match the H1 exactly?

Yes. The content blueprint treats headline consistency as part of citation quality. If the H1 and headline diverge, AI can cite the wrong title.

Can I omit the publisher logo?

Yes for a personal site or solo creator brand if there is no real publication logo. But for newsroom-style publishing, the blueprint expects a logo because it strengthens institutional attribution.

Do I need author sameAs links?

Yes. The current field map expects at least one external profile for the author. That is one of the simplest ways to make authorship verifiable to AI systems.

Should I mirror visible FAQs in FAQPage markup?

Yes if the article genuinely contains those questions and answers. The structured FAQ should match visible page content, not introduce hidden claims.

Test your structured data

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

Open Validator →