Sample File Outputs

Explore examples of what each format looks like in practice. Geordy's files are designed to be clean, standardized, and model-friendly.

Below are examples of what each format looks like in practice. Geordy's files are designed to be clean, standardized, and model-friendly.

YAML (geordy.yaml)

The YAML format provides a hierarchical, human-readable structure of your site's pages and metadata.

geordy.yamlYAML
site:
  name: "Example Store"
  url: "https://example.com"
  description: "Your trusted source for eco-friendly products"
  updated: "2025-10-07"

pages:
  - title: "Home"
    url: "https://example.com"
    description: "Welcome to Example Store"
    updated: "2025-10-07"
    priority: "high"
    
  - title: "Shop"
    url: "https://example.com/shop"
    description: "Browse our collection of sustainable products"
    updated: "2025-10-05"
    priority: "high"
    
  - title: "About Us"
    url: "https://example.com/about"
    description: "Learn about our mission and values"
    updated: "2025-09-15"
    priority: "normal"

Markdown (page.md)

Markdown files contain clean, formatted text versions of your page content without HTML noise.

page.mdMARKDOWN
# Example Store

Your trusted source for eco-friendly products.

## Featured Products

- **Bamboo Toothbrush** - Sustainable oral care solution
- **Reusable Glass Bottle** - Stay hydrated without plastic
- **Organic Cotton Bag** - Durable shopping companion

## Why Choose Us?

We're committed to providing high-quality, sustainable products that make a positive impact on the environment. Every purchase supports our mission to reduce plastic waste and promote eco-conscious living.

## Contact

Email: [email protected]  
Phone: (555) 123-4567

llms.txt

The llms.txt file follows the llmstxt.org specification. It is a curated markdown document — not a directive file — that helps AI models understand what a site is about and where to find its most relevant content. It starts with an H1 site name, a one-sentence blockquote summary, and optional H2 sections listing links to key resources.

llms.txtMARKDOWN
# Example Store

> Example Store is an online retailer of eco-friendly, sustainably sourced everyday products for environmentally conscious consumers.

Example Store ships across the US and offers fully compostable packaging. Every product is vetted against strict sustainability criteria before listing.

## Products

- [Shop — Full Product Catalogue](https://example.com/shop): Browse all available sustainable products by category.
- [Bamboo & Wood Essentials](https://example.com/shop/bamboo): Kitchenware, personal care, and home items made from renewable materials.
- [Reusable Bottles & Bags](https://example.com/shop/reusables): Zero-waste alternatives to single-use plastic packaging.

## Company

- [About Example Store](https://example.com/about): Mission, values, and the founding story behind the brand.
- [Sustainability Commitments](https://example.com/sustainability): Full breakdown of sourcing standards, packaging choices, and carbon offset programs.

## Support

- [Shipping & Returns](https://example.com/help/shipping): Delivery times, return policy, and order tracking guidance.
- [Contact Us](https://example.com/contact): Email and live chat support entry points.

## Optional

- [Blog — Winter 2025 Collection](https://example.com/blog/winter-collection): New arrivals and seasonal product highlights.
- [Blog — Packaging Update](https://example.com/blog/packaging-update): Announcement of the switch to 100% compostable mailers.

Sitemap XML (sitemap.xml)

The sitemap.xml file provides a complete map of your site structure for search engines and AI crawlers.

sitemap.xmlXML
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <url>
    <loc>https://example.com</loc>
    <lastmod>2025-10-07</lastmod>
    <changefreq>weekly</changefreq>
    <priority>1.0</priority>
  </url>
  
  <url>
    <loc>https://example.com/shop</loc>
    <lastmod>2025-10-05</lastmod>
    <changefreq>daily</changefreq>
    <priority>0.9</priority>
  </url>
  
  <url>
    <loc>https://example.com/about</loc>
    <lastmod>2025-09-15</lastmod>
    <changefreq>monthly</changefreq>
    <priority>0.7</priority>
  </url>
  
  <url>
    <loc>https://example.com/contact</loc>
    <lastmod>2025-09-10</lastmod>
    <changefreq>monthly</changefreq>
    <priority>0.6</priority>
  </url>
  
  <url>
    <loc>https://example.com/blog/winter-collection</loc>
    <lastmod>2025-10-07</lastmod>
    <changefreq>weekly</changefreq>
    <priority>0.8</priority>
  </url>
  
  <url>
    <loc>https://example.com/blog/packaging-update</loc>
    <lastmod>2025-10-04</lastmod>
    <changefreq>weekly</changefreq>
    <priority>0.8</priority>
  </url>
</urlset>

RSS Feed (feed.rss)

RSS feeds signal fresh content and posting frequency to AI models and aggregators.

feed.rssXML
<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
  <channel>
    <title>Example Store Updates</title>
    <link>https://example.com</link>
    <description>Latest products and announcements from Example Store</description>
    <language>en-us</language>
    <lastBuildDate>Mon, 07 Oct 2025 10:00:00 GMT</lastBuildDate>
    <atom:link href="https://geo.example.com/feed.rss" rel="self" type="application/rss+xml"/>
    
    <item>
      <title>New Winter Collection Launched</title>
      <link>https://example.com/blog/winter-collection</link>
      <description>Discover our latest sustainable winter products designed for cold weather.</description>
      <pubDate>Mon, 07 Oct 2025 09:00:00 GMT</pubDate>
      <guid>https://example.com/blog/winter-collection</guid>
    </item>
    
    <item>
      <title>Eco-Friendly Packaging Update</title>
      <link>https://example.com/blog/packaging-update</link>
      <description>We've upgraded to 100% compostable packaging materials.</description>
      <pubDate>Fri, 04 Oct 2025 14:30:00 GMT</pubDate>
      <guid>https://example.com/blog/packaging-update</guid>
    </item>
  </channel>
</rss>

Schema JSON (schema.json)

Schema JSON provides structured data using Schema.org vocabulary for search engines and AI models.

schema.jsonJSON
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Example Store",
  "url": "https://example.com",
  "logo": "https://example.com/logo.png",
  "description": "Your trusted source for eco-friendly products",
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "+1-555-123-4567",
    "contactType": "Customer Service",
    "email": "[email protected]"
  },
  "sameAs": [
    "https://twitter.com/examplestore",
    "https://facebook.com/examplestore",
    "https://instagram.com/examplestore"
  ],
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "123 Green Street",
    "addressLocality": "Portland",
    "addressRegion": "OR",
    "postalCode": "97201",
    "addressCountry": "US"
  }
}

Open Graph JSON (page.og.json)

Open Graph JSON provides structured social sharing metadata in a machine-readable format, describing how each page should appear when shared or cited by AI systems and social platforms.

about.og.jsonJSON
{
  "og:title": "About Example Store",
  "og:description": "Learn about our mission to make eco-friendly living accessible to everyone.",
  "og:url": "https://example.com/about",
  "og:type": "website",
  "og:site_name": "Example Store",
  "og:image": "https://example.com/images/about-og.jpg",
  "og:image:width": "1200",
  "og:image:height": "630",
  "og:image:alt": "The Example Store team at our Portland headquarters",
  "og:locale": "en_US",
  "twitter:card": "summary_large_image",
  "twitter:site": "@examplestore",
  "twitter:title": "About Example Store",
  "twitter:description": "Learn about our mission to make eco-friendly living accessible to everyone.",
  "twitter:image": "https://example.com/images/about-og.jpg"
}

Humans Attribution (humans.txt)

The humans.txt file is an informal standard for crediting the people and tools behind a website. Geordy generates it automatically to document your site's team, technology stack, and last update date — making it readable by both humans and AI agents auditing your site.

humans.txtTEXT
/* TEAM */
Creator: Example Store
Contact: [email protected]
Location: Portland, Oregon, US

/* SITE */
Last update: 2025/10/07
Language: English
Doctype: HTML5
IDE: Visual Studio Code

/* TECHNOLOGY */
CMS: Custom
Framework: Next.js
Hosting: Vercel
AI Visibility: Geordy (https://geordy.ai)

Manifest JSON (manifest.json)

Web app metadata for AI and app discovery, describing your site's identity.

manifest.jsonJSON
{
  "name": "Example Store",
  "short_name": "Example",
  "description": "Your trusted source for eco-friendly products",
  "start_url": "https://example.com",
  "display": "standalone",
  "background_color": "#ffffff",
  "theme_color": "#2d6a4f",
  "icons": [
    {
      "src": "https://example.com/icon-192.png",
      "sizes": "192x192",
      "type": "image/png"
    },
    {
      "src": "https://example.com/icon-512.png",
      "sizes": "512x512",
      "type": "image/png"
    }
  ]
}

Consistent, AI-Readable Structured Outputs

YAML Format
site:
  name: "Example Store"
  url: "https://example.com"
pages:
  - title: "Home"
    priority: "high"

All formats follow consistent naming patterns and are hosted on your custom subdomain for easy AI access.

Accessing Your Files

All generated files are accessible on your custom subdomain. For example, if your subdomain is geo.example.com, you can access:

  • https://geo.example.com/geordy.yaml
  • https://geo.example.com/schema.json
  • https://geo.example.com/llms.txt
  • https://geo.example.com/sitemap.xml
  • https://geo.example.com/feed.rss
  • https://geo.example.com/manifest.json
  • https://geo.example.com/about.og.json
  • https://geo.example.com/humans.txt

Section Summary

After reviewing this section, you should:

  • Understand the purpose and structure of every supported file format
  • Know how to test, validate, and link each format properly
  • Recognize how these files collectively form the backbone of your site's AI visibility
← JSON-LD SchemaSecurity & Compliance →