The homepage is the identity anchor for any retail store — boutiques, hardware stores, bookshops, gift shops, and any brick-and-mortar business that sells physical goods. It tells AI systems who you are, what you sell, where you are, and when you are open. This blueprint provides the complete JSON-LD graph your homepage needs.
The homepage is where AI systems look first to understand your retail store. It must declare your identity, location, what you sell, your hours, and how to reach you. Without this structured data, AI cannot recommend your store when someone searches for specific products or shops nearby.
Store node declares your name, phone number, price range, and social profiles. This is the canonical record AI uses to identify your business.PostalAddress and GeoCoordinates let AI systems answer "stores near me" queries and provide directions.openingHoursSpecification array tells AI exactly when your store is open for shopping.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
nameurltelephoneaddressgeoopeningHoursSpecificationpriceRangesameAsimage@idCopy 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 Store 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. Domain 3. Faq answer 4. Faq question 5. Handle 6. Homepage title 7. Latitude 8. Logo 9. Longitude 10. Maps cid 11. Page 12. Payment methods 13. Phone number 14. Price range 15. Saturday close 16. Saturday open 17. State 18. Storefront image 19. Store name 20. Street address 21. Sunday close 22. Sunday open 23. Weekday close 24. Weekday open 25. 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 Store 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
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": "Store",
"@id": "https://YOUR_DOMAIN.com/#store",
"name": "YOUR_STORE_NAME",
"url": "https://YOUR_DOMAIN.com",
"logo": "https://YOUR_DOMAIN.com/YOUR_LOGO.png",
"image": "https://YOUR_DOMAIN.com/YOUR_STOREFRONT_IMAGE.jpg",
"telephone": "YOUR_PHONE_NUMBER",
"priceRange": "YOUR_PRICE_RANGE",
"paymentAccepted": "YOUR_PAYMENT_METHODS",
"currenciesAccepted": "USD",
"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"
},
"openingHoursSpecification": [
{
"@type": "OpeningHoursSpecification",
"dayOfWeek": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"],
"opens": "YOUR_WEEKDAY_OPEN",
"closes": "YOUR_WEEKDAY_CLOSE"
},
{
"@type": "OpeningHoursSpecification",
"dayOfWeek": "Saturday",
"opens": "YOUR_SATURDAY_OPEN",
"closes": "YOUR_SATURDAY_CLOSE"
},
{
"@type": "OpeningHoursSpecification",
"dayOfWeek": "Sunday",
"opens": "YOUR_SUNDAY_OPEN",
"closes": "YOUR_SUNDAY_CLOSE"
}
],
"sameAs": [
"https://www.instagram.com/YOUR_HANDLE",
"https://www.facebook.com/YOUR_PAGE",
"https://www.google.com/maps?cid=YOUR_MAPS_CID"
]
},
{
"@type": "WebSite",
"@id": "https://YOUR_DOMAIN.com/#website",
"name": "YOUR_STORE_NAME",
"url": "https://YOUR_DOMAIN.com"
},
{
"@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/#store"
}
},
{
"@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"
}
}
]
}
]
}
Store is the general type for retail businesses. Schema.org has more specific subtypes like BookStore, ClothingStore, HardwareStore, JewelryStore, and others. If a specific subtype matches your store, use that for better AI classification. Use Store when no subtype fits.
List the payment methods your store accepts as a comma-separated string: "Cash, Credit Card, Debit Card, Apple Pay, Google Pay". This helps AI answer practical shopping questions like "do they take credit cards?"
You can use hasOfferCatalog to list your main product categories. This helps AI understand what you sell at a high level. Detailed product listings belong on the products page, but a category overview on the homepage gives AI a useful starting point.