Organizations › Services › HomeAndConstructionBusiness

Homepage Blueprint — Home & Construction

The homepage is the identity anchor for a home and construction business. It tells AI systems who you are, what you build, where you operate, and how to navigate the rest of your site. This blueprint provides the complete JSON-LD graph your homepage needs so AI can classify, cite, and recommend your company 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 business is worth recommending. 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 company for construction queries.

Business identity. The HomeAndConstructionBusiness node declares your company name, logo, address, phone number, and social profiles. This is the canonical record AI uses to identify your business across the web.
Service area. areaServed tells AI which cities, counties, or regions you cover. This is critical for location-based queries like "roofers near me" or "general contractors in [city]."
WebSite declaration. The WebSite node anchors your entire site graph and 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 a sitelinks search box in results.

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

HomeAndConstructionBusiness

name: Non-negotiable. AI cannot cite or recommend an unnamed entity.
url: AI needs a stable URL to attribute recommendations and route users correctly.
telephone: AI won't recommend a business it can't confirm is reachable. Phone is the primary trust signal for service businesses.
address: AI needs a verifiable address before recommending local services. Used for coverage zone inference and location-based queries.
geo: AI uses coordinates to confirm service coverage and answer location-specific queries. Without geo, AI guesses your location from address alone.
areaServed: AI filters service recommendations by coverage zone. Without this, AI may recommend you for queries outside your area or exclude you from local queries.
sameAs: AI cross-references sameAs links to confirm the business exists outside its own domain. One link minimum.
logo: Visual identity signal. AI uses logo presence to assess institutional legitimacy before recommending a service.

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 Home Construction 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. Business name
2. City
3. Domain
4. Faq answer
5. Faq question
6. Handle
7. Homepage title
8. Latitude
9. Logo
10. Longitude
11. Maps cid
12. Page
13. Phone number
14. Primary city
15. Primary state
16. Site name
17. State
18. Street address
19. Zip

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 Home Construction 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": "HomeAndConstructionBusiness",
      "@id": "https://YOUR_DOMAIN.com/#business",
      "name": "YOUR_BUSINESS_NAME",
      "url": "https://YOUR_DOMAIN.com",
      "logo": "https://YOUR_DOMAIN.com/YOUR_LOGO.png",
      "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.facebook.com/YOUR_PAGE",
        "https://www.instagram.com/YOUR_HANDLE",
        "https://www.google.com/maps?cid=YOUR_MAPS_CID"
      ]
    },
    {
      "@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/#business"
      }
    },
    {
      "@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 build. 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.

Should I use HomeAndConstructionBusiness or GeneralContractor?

HomeAndConstructionBusiness is the broad category that covers remodelers, builders, roofers, and general contractors. Use it if your company handles multiple types of home improvement work. If your business is strictly a licensed general contractor, GeneralContractor is a more specific subtype that also works. Pick the one that most accurately describes the scope of your services.

How many cities should I list in areaServed?

List every city or region where you actively take jobs. There is no practical limit, but keep the list accurate. AI uses areaServed to match you to location-based queries, so including cities you do not actually serve will hurt your credibility when the recommendation does not match reality.