--- title: "Guide" description: "Geordy in plain English - what it does, what you get, how to use it." section: "Learn" canonical: "https://geordy.ai/docs/guide" --- # Guide Geordy in plain English - what it does, what you get, how to use it. ## What you get Geordy takes a page from your site and produces extra machine-readable versions of it - so AI systems can understand what the page means without guessing. Your site looks the same to visitors. You're just adding a clean, structured layer for machines. The platform generates eight file formats per page: - Markdown (.md) - clean page version for AI - Schema JSON - structured "meaning" data - llms.txt - clear site rules for LLMs (homepage only) - YAML - lightweight structured data - OG.json - Open Graph metadata as JSON - RSS (.xml) - feed format for updates - manifest.json - app manifest metadata - humans.txt - human-readable credits file (homepage only) ## The shortest path to value Five steps, and one of them is optional. ### 1. Pick one page Homepage, top landing page, pricing, or your best product or category page. Drop the URL into Geordy and generate the formats. ### 2. Enable the right formats Start with Schema JSON, Markdown, and llms.txt (homepage only). Add OG.json, YAML, RSS, manifest, and humans.txt when you're ready. ### 3. Put files somewhere accessible Two options. Option A: use Geordy's URL directly. Your files are already live at Geordy's address the moment they're generated - files.geordy.ai/yourdomain.com/llms.txt. Option B (optional): your own subdomain via one DNS A record pointing at 178.156.151.211. This puts the files under your own brand rather than ours. Nothing waits on it: your files are already serving from Option A. ### 4. Verify it works Open your files in a browser: files.geordy.ai/yourdomain.com/llms.txt, or ai.yourdomain.com/llms.txt if you added the subdomain. If it loads, you are done. ### 5. Add reference tags Insert tags in the page so AI crawlers can discover the structured files. **Homepage (8 files)** ```html ``` **Inner pages (6 files)** ```html ``` > The slug matches the page path. /about → about.md, /pricing → pricing.md. ## Post-deployment verification 1. DNS working - visit ai.yourdomain.com/llms.txt in your browser; the file should load. 2. Tags installed - view page source, search for "llms.txt" or your subdomain; the tags should appear in . 3. Files accessible - click through each file URL; all should return content (not 404). ## How URLs map Two files live only on the homepage: /llms.txt and /humans.txt. Everything else mirrors your site paths. ### Homepage files - ai.yourdomain.com/index.md - ai.yourdomain.com/index.schema.json - ai.yourdomain.com/index.yaml - ai.yourdomain.com/index.og.json - ai.yourdomain.com/index.xml - ai.yourdomain.com/index.manifest.json ### Inner page example (/about/team) - ai.yourdomain.com/about/team.md - ai.yourdomain.com/about/team.schema.json - ai.yourdomain.com/about/team.yaml - ai.yourdomain.com/about/team.og.json - ai.yourdomain.com/about/team.xml - ai.yourdomain.com/about/team.manifest.json ## Scaling up 1. Top 5 rollout - homepage, pricing, top category, top product, about/credibility page first. 2. Sitemap import - once working, import your XML sitemap and process in batches, prioritizing money pages. 3. Dynamic link tags - add a single template to your global that builds file URLs from the current page path automatically. 4. Keep a refresh cadence on pages that change. Set a page's Frequency to Off once you have edited one of its formats by hand and want it to hold. 5. Fix the source page first. If a generated format feels wrong, the original page is usually unclear to machines. Fix the page, regenerate. **Dynamic pattern** ```html ``` Where {slug} equals the current page path or "index" for the homepage. Tags auto-generate for every page; new pages are covered automatically; no manual updates needed. --- Source: https://geordy.ai/docs/guide This is a machine-readable markdown version of that page, generated by Geordy.