Organizations › Services › ProfessionalService

Homepage Blueprint — Professional Service

The homepage is the identity anchor for a professional service website. It tells AI systems who the organization is, what it does, where it operates, and how to navigate the rest of the site. This blueprint provides the complete JSON-LD graph your homepage needs so AI can classify, cite, and recommend your firm with confidence.

View Prompt View JSON

What this page needs

The homepage is the single most important page for AI discoverability. It is where AI systems look first to understand who you are and whether your firm is worth citing. Every other page on the site inherits credibility from what the homepage declares. Without structured data here, AI may index deeper pages but still lack the identity anchor needed to recommend your business.

Organization identity. The Organization node declares your firm's name, logo, address, contact information, founding date, and social profiles. This is the canonical record AI uses to identify your business across the web.
WebSite declaration. The WebSite node anchors your entire site graph. It gives AI a root-level reference that every other page can point back to with isPartOf.
Search action for sitelinks. A SearchAction inside potentialAction tells search engines and AI systems that your site has internal search, which can trigger sitelinks search box in results.
Service overview. The WebPage node with an about reference to the Organization connects the homepage to the entity it represents, closing the loop between the page and the business.

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

Organization

name: Non-negotiable. AI cannot cite or recommend an unnamed entity.
url: AI needs a stable URL to attribute recommendations and route users correctly.
email: Primary contact signal for online services. AI won't recommend a service it can't confirm is reachable.
logo: Visual identity signal. AI uses logo presence to assess institutional legitimacy before recommending a service.
contactPoint: AI needs a customer service path before recommending a service from an unfamiliar provider.
areaServed: AI uses this to confirm whether the service is available in the user's location. Worldwide, national, or regional — specify it.
sameAsconditional: AI cross-references sameAs links to confirm the organization exists 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 and AI sees isolated, unrelated data.

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 Professional Service Homepage 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. City
2. Company
3. Domain
4. Email
5. Employee count
6. Faq answer
7. Faq question
8. Founding year
9. Handle
10. Homepage title
11. Latitude
12. Logo
13. Longitude
14. Maps cid
15. Organization name
16. Phone number
17. Primary city
18. Primary state
19. Site name
20. State
21. Street address
22. Zip

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 Professional Service Homepage"
- 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. This block belongs in a <script type="application/ld+json"> tag in the <head> of your homepage.

{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "Organization",
      "@id": "https://YOUR_DOMAIN.com/#organization",
      "name": "YOUR_ORGANIZATION_NAME",
      "url": "https://YOUR_DOMAIN.com",
      "logo": "https://YOUR_DOMAIN.com/YOUR_LOGO.png",
      "email": "YOUR_EMAIL",
      "telephone": "YOUR_PHONE_NUMBER",
      "address": {
        "@type": "PostalAddress",
        "streetAddress": "YOUR_STREET_ADDRESS",
        "addressLocality": "YOUR_CITY",
        "addressRegion": "YOUR_STATE",
        "postalCode": "YOUR_ZIP",
        "addressCountry": "US"
      },
      "geo": {
        "@type": "GeoCoordinates",
        "latitude": "YOUR_LATITUDE",
        "longitude": "YOUR_LONGITUDE"
      },
      "areaServed": [
        {
          "@type": "City",
          "name": "YOUR_PRIMARY_CITY"
        },
        {
          "@type": "State",
          "name": "YOUR_PRIMARY_STATE"
        }
      ],
      "sameAs": [
        "https://www.linkedin.com/company/YOUR_COMPANY",
        "https://twitter.com/YOUR_HANDLE",
        "https://www.google.com/maps?cid=YOUR_MAPS_CID"
      ],
      "contactPoint": {
        "@type": "ContactPoint",
        "telephone": "YOUR_PHONE_NUMBER",
        "email": "YOUR_EMAIL",
        "contactType": "customer support"
      },
      "foundingDate": "YOUR_FOUNDING_YEAR",
      "numberOfEmployees": {
        "@type": "QuantitativeValue",
        "value": "YOUR_EMPLOYEE_COUNT"
      }
    },
    {
      "@type": "WebSite",
      "@id": "https://YOUR_DOMAIN.com/#website",
      "name": "YOUR_SITE_NAME",
      "url": "https://YOUR_DOMAIN.com",
      "potentialAction": {
        "@type": "SearchAction",
        "target": "https://YOUR_DOMAIN.com/?s={search_term_string}",
        "query-input": "required name=search_term_string"
      }
    },
    {
      "@type": "WebPage",
      "@id": "https://YOUR_DOMAIN.com/#webpage",
      "url": "https://YOUR_DOMAIN.com/",
      "name": "YOUR_HOMEPAGE_TITLE",
      "isPartOf": {
        "@id": "https://YOUR_DOMAIN.com/#website"
      },
      "about": {
        "@id": "https://YOUR_DOMAIN.com/#organization"
      }
    },
    {
      "@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 does the homepage need its own JSON-LD block?

The homepage is the identity anchor for your entire site. AI systems treat it as the canonical source for who you are, where you operate, and what you do. Other pages reference the homepage graph via @id and isPartOf, so without structured data here, deeper pages lose their connection to your core business identity.

Do I need the SearchAction if my site does not have search?

No. The SearchAction inside potentialAction is only useful if your site has a working internal search. If it does not, remove the entire potentialAction block. Including a broken search URL can hurt rather than help.

Should the BreadcrumbList on the homepage only have one item?

Yes. The homepage sits at the top of the site hierarchy, so its breadcrumb only contains a single item: "Home" at position 1. Deeper pages will reference longer breadcrumb chains, but the homepage itself is the root.