---
title: "Setup"
description: "Add your site, Geordy writes the files, Add the link tags."
section: "Get started"
canonical: "https://geordy.ai/docs/setup"
---
# Setup

Add your site, Geordy writes the files, Add the link tags.

## Step 1 · Add your site

Create a free account, then start with the single most important page on your site. Don't start with the whole site.

- Homepage
- Top landing page
- Pricing
- Best-performing product or category page

Drop that URL into Geordy. Once you're happy with what comes back, paste your sitemap and onboard the rest in batches.

## Step 2 · Geordy writes the files

Geordy reads the page and writes the matching formats. You choose which ones it writes. For most sites, begin with three core formats:

- Schema JSON - structured meaning data
- Markdown - clean page content for AI
- llms.txt - homepage only

Optional additions: OG.json, YAML, RSS (.xml), manifest.json, humans.txt. Enable what you'll actually deploy.

### Where the files live

Your files are already hosted at Geordy's address the moment they're generated - no DNS, no configuration needed. Reference format: files.geordy.ai/yourdomain.com/llms.txt. That is the whole of it for most sites, and it is what every free account gets.

### Optional · your own subdomain

Not a setup step, and nothing waits on it: your files serve either way. When you would rather they sat under your own brand, add one A record to your DNS.

**DNS record**
```dns
Type:  A
Host:  ai (or any subdomain)
Value: 178.156.151.211
```

> No wildcard, no TXT, no CNAME needed. Just one A record covers all files for that domain.

Suggested subdomains: ai.yourdomain.com, geordy.yourdomain.com, data.yourdomain.com.

## Step 3 · Point AI at them

Insert <link rel="alternate"> tags in the page <head> pointing to Geordy files.

**Reference tags**
```html
<!-- On Geordy's address, which works with no DNS -->
<link rel="alternate"
      type="application/ld+json"
      href="https://files.geordy.ai/yourdomain.com/about/team.schema.json" />
<link rel="alternate"
      type="text/markdown"
      href="https://files.geordy.ai/yourdomain.com/about/team.md" />

<!-- Or on your own subdomain, once you have added the A record -->
<link rel="alternate"
      type="application/ld+json"
      href="https://ai.yourdomain.com/about/team.schema.json" />
<link rel="alternate"
      type="text/markdown"
      href="https://ai.yourdomain.com/about/team.md" />
```

> This is the activation step. Without reference tags, AI systems can't discover the files.

### Check it worked

Open the file address your tags point at.

- On Geordy's address: files.geordy.ai/yourdomain.com/llms.txt
- On your own subdomain: ai.yourdomain.com/llms.txt

If it loads, you're live. If your own subdomain doesn't load yet, DNS propagation can take a few minutes to an hour.
---

Source: https://geordy.ai/docs/setup
This is a machine-readable markdown version of that page, generated by Geordy.