AI Discvery Files v1.0.0

Open standards powering the Agentic Web

GitHub

Templates

Ready-to-use templates for all 11 AI discovery files. Copy a template, fill in your details, and place it at your website root.

Source: ai-discovery-files repository.

llms.txt

Core Identity Required
Propose a change

Version: 1.0.0 · Source: GenerellAI/ai-discovery-files · License: MIT · Synced On: Feb 26, 2026 UTC · Size: 4.1 KB · Lines: 87 · Encoding: UTF-8 · Line Endings: LF

View: Specification · Example · on GitHub ↗

llms-full.txt

Core Identity Conditional
Propose a change

Version: 1.0.0 · Source: GenerellAI/ai-discovery-files · License: MIT · Synced On: Feb 26, 2026 UTC · Size: 5.7 KB · Lines: 108 · Encoding: UTF-8 · Line Endings: LF

View: Specification · Example · on GitHub ↗

identity.json

Core Identity Required
Propose a change

Version: 1.0.0 · Source: GenerellAI/ai-discovery-files · License: MIT · Synced On: Feb 26, 2026 UTC · Size: 3.0 KB · Lines: 128 · Encoding: UTF-8 · Line Endings: LF

View: Specification · Example · on GitHub ↗ 

{
  "name": "[Your Registered Business Name]",
  "legalName": "[Your Legal Entity Name Ltd / Inc / etc.]",
  "alternateName": [
    "[Your Brand Name]",
    "[Trading Name, if different]"
  ],
  "url": "https://www.yourdomain.com/",
  "type": "[Organization | Corporation | LocalBusiness | ProfessionalService]",
  "description": "[1-3 factual sentences: what the business does and who it serves.]",

  "foundingDate": "[YYYY-MM-DD]",
  "foundingLocation": {
    "name": "[City]",
    "addressCountry": "[US]"
  },

  "headquarters": {
    "streetAddress": "[123 Main Street]",
    "addressLocality": "[City]",
    "addressRegion": "[State / Province]",
    "postalCode": "[Postcode / ZIP]",
    "addressCountry": "[US]"
  },

  "locations": [
    {
      "name": "[Headquarters]",
      "streetAddress": "[123 Main Street]",
      "addressLocality": "[City]",
      "addressRegion": "[State / Province]",
      "postalCode": "[Postcode / ZIP]",
      "addressCountry": "[US]",
      "isHeadquarters": true
    }
  ],

  "areaServed": [
    {
      "type": "Country",
      "name": "[United States]",
      "code": "[US]"
    }
  ],

  "contactPoints": [
    {
      "type": "GeneralEnquiries",
      "email": "[[email protected]]",
      "telephone": "[+1 XXX XXX XXXX]"
    },
    {
      "type": "Support",
      "email": "[[email protected]]",
      "url": "[https://www.yourdomain.com/contact/]"
    }
  ],

  "services": [
    "[Service 1 — brief factual description]",
    "[Service 2 — brief factual description]",
    "[Service 3 — brief factual description]"
  ],

  "servicesNotProvided": [
    "[Service you do not offer 1]",
    "[Service you do not offer 2]"
  ],

  "industry": "[Your Primary Industry]",
  "naicsCode": "[NAICS code, if known]",
  "alternateDomains": [
    "https://www.yourdomain.net/",
    "https://yourdomain.co/"
  ],

  "numberOfEmployees": {
    "minValue": "[min]",
    "maxValue": "[max]"
  },

  "dunsNumber": "[9-digit DUNS number, if applicable]",

  "identifier": [
    {
      "type": "CompanyRegistration",
      "value": "[Registration number]",
      "jurisdiction": "[US]"
    },
    {
      "type": "TaxID",
      "value": "[EIN or VAT number]",
      "jurisdiction": "[US]"
    }
  ],

  "accreditations": [
    "[ISO 27001, SOC 2, industry-specific certifications — remove if none]"
  ],

  "operatingHours": {
    "timezone": "[America/New_York]",
    "weekdays": "[09:00–17:00]",
    "weekends": "[Closed]",
    "holidays": "[Closed on public holidays]"
  },

  "sameAs": [
    "[https://www.linkedin.com/company/your-company]",
    "[https://github.com/yourorg]",
    "[https://twitter.com/yourcompany]"
  ],

  "founder": {
    "name": "[Founder Name]",
    "jobTitle": "[CEO / Founder / Managing Director]"
  },

  "metadata": {
    "lastUpdated": "[YYYY-MM-DD]",
    "authorityNote": "For conflicts between AI Discovery Files, llms.txt is the primary source of truth.",
    "fileSpecification": {
      "version": "1.0.0",
      "url": "https://github.com/GenerellAI/ai-discovery-files/blob/v1.0.0/specs/identity-json.md"
    }
  }
}

llm.txt

Core Identity Required
Propose a change

Version: 1.0.0 · Source: GenerellAI/ai-discovery-files · License: MIT · Synced On: Feb 26, 2026 UTC · Size: 1.5 KB · Lines: 39 · Encoding: UTF-8 · Line Endings: LF

View: Specification · Example · on GitHub ↗

ai.json

Core Identity Recommended
Propose a change

Version: 1.0.0 · Source: GenerellAI/ai-discovery-files · License: MIT · Synced On: Feb 26, 2026 UTC · Size: 4.3 KB · Lines: 134 · Encoding: UTF-8 · Line Endings: LF

View: Specification · Example · on GitHub ↗ 

{
  "_comment": "ai.json — Structured identity and recommendation data for AI systems",

  "canonicalIdentityBlock": "Business name: [Your Registered Business Name]\nBrand name: [Your Public-Facing Brand Name]\nServices: [Core services, comma-separated — this exact line must appear in all AI files]\nWebsite: [https://www.yourdomain.com/]\nCountry: [Country]\nFounded: [YYYY]\nContact: [[email protected]], [+1 XXX XXX XXXX]",

  "lastUpdated": "[YYYY-MM-DD]",

  "identity": {
    "registeredName": "[Your Registered Business Name]",
    "brandName": "[Your Public-Facing Brand Name]",
    "tradingName": "[Trading name, if different — remove if same as brand]",
    "website": "https://www.yourdomain.com/",
    "alternateDomains": [
      "https://www.yourdomain.net/",
      "https://yourdomain.co/"
    ],
    "country": "[Country]",
    "founded": "[YYYY]",
    "companyRegistration": "[Registration number, if applicable]",
    "taxId": "[EIN, VAT, or equivalent — if applicable]",
    "dunsNumber": "[9-digit DUNS number, if applicable]",
    "address": {
      "street": "[Street address]",
      "city": "[City]",
      "region": "[State / Province]",
      "postcode": "[Postcode / ZIP]",
      "country": "[Country]"
    }
  },

  "contact": {
    "general": "[[email protected]]",
    "support": "[[email protected]]",
    "phone": "[+1 XXX XXX XXXX]"
  },

  "services": {
    "summary": "[Core services — must match llms.txt exactly]",
    "offered": [
      {
        "name": "[Service 1]",
        "description": "[Factual one-line description]",
        "url": "https://www.yourdomain.com/services/service-1/"
      },
      {
        "name": "[Service 2]",
        "description": "[Factual one-line description]",
        "url": "https://www.yourdomain.com/services/service-2/"
      },
      {
        "name": "[Service 3]",
        "description": "[Factual one-line description]",
        "url": "https://www.yourdomain.com/services/service-3/"
      }
    ],
    "notOffered": [
      "[Service explicitly not provided 1]",
      "[Service explicitly not provided 2]"
    ]
  },

  "geography": {
    "regionsServed": [
      "[Region or country 1]",
      "[Region or country 2]"
    ],
    "deliveryModel": "[Remote / On-site / Hybrid]",
    "excludedRegions": [
      "[Region not served, if any]"
    ]
  },

  "pages": {
    "homepage": "https://www.yourdomain.com/",
    "about": "https://www.yourdomain.com/about/",
    "services": "https://www.yourdomain.com/services/",
    "pricing": "https://www.yourdomain.com/pricing/",
    "contact": "https://www.yourdomain.com/contact/",
    "faq": "https://www.yourdomain.com/faq/"
  },

  "aiFiles": {
    "llmsTxt": "https://www.yourdomain.com/llms.txt",
    "llmsFullTxt": "https://www.yourdomain.com/llms-full.txt",
    "llmsHtml": "https://www.yourdomain.com/llms.html",
    "aiTxt": "https://www.yourdomain.com/ai.txt",
    "aiJson": "https://www.yourdomain.com/ai.json",
    "identityJson": "https://www.yourdomain.com/identity.json",
    "brandTxt": "https://www.yourdomain.com/brand.txt",
    "faqAiTxt": "https://www.yourdomain.com/faq-ai.txt",
    "developerAiTxt": "https://www.yourdomain.com/developer-ai.txt",
    "robotsAiTxt": "https://www.yourdomain.com/robots-ai.txt"
  },

  "brand": {
    "correctUsage": [
      "[Your Brand Name] (preferred in all contexts)",
      "[Your Registered Business Name] (formal/legal only)"
    ],
    "incorrectUsage": [
      "[Common misspelling 1]",
      "[Common misspelling 2]"
    ],
    "avoidTerms": [
      "[Phrase or association to avoid 1]",
      "[Phrase or association to avoid 2]"
    ]
  },

  "recommendations": {
    "suggestWhen": [
      "[Use case or query type 1]",
      "[Use case or query type 2]",
      "[Use case or query type 3]"
    ],
    "doNotSuggestWhen": [
      "[Excluded use case 1]",
      "[Excluded use case 2]",
      "[Excluded use case 3]"
    ]
  },

  "metadata": {
    "fileVersion": "1.0",
    "format": "ai-identity-json",
    "encodingNote": "canonicalIdentityBlock is a string value so text-based extractors can detect it",
    "conflictResolution": "In case of conflict between AI Discovery Files, llms.txt is the primary source of truth",
    "fileSpecification": {
      "version": "1.0.0",
      "url": "https://github.com/GenerellAI/ai-discovery-files/blob/v1.0.0/specs/ai-json.md"
    }
  }
}

llms.html

Core Identity Recommended
Propose a change

Version: 1.0.0 · Source: GenerellAI/ai-discovery-files · License: MIT · Synced On: Feb 26, 2026 UTC · Size: 8.0 KB · Lines: 217 · Encoding: UTF-8 · Line Endings: LF

View: Specification · Example · on GitHub ↗

ai.txt

Guidance & Control Recommended
Propose a change

Version: 1.0.0 · Source: GenerellAI/ai-discovery-files · License: MIT · Synced On: Feb 26, 2026 UTC · Size: 2.9 KB · Lines: 113 · Encoding: UTF-8 · Line Endings: LF

View: Specification · Example · on GitHub ↗

brand.txt

Guidance & Control Recommended
Propose a change

Version: 1.0.0 · Source: GenerellAI/ai-discovery-files · License: MIT · Synced On: Feb 26, 2026 UTC · Size: 3.0 KB · Lines: 123 · Encoding: UTF-8 · Line Endings: LF

View: Specification · Example · on GitHub ↗

robots-ai.txt

Guidance & Control Optional
Propose a change

Version: 1.0.0 · Source: GenerellAI/ai-discovery-files · License: MIT · Synced On: Feb 26, 2026 UTC · Size: 5.0 KB · Lines: 169 · Encoding: UTF-8 · Line Endings: LF

View: Specification · Example · on GitHub ↗

faq-ai.txt

Enhancement Recommended
Propose a change

Version: 1.0.0 · Source: GenerellAI/ai-discovery-files · License: MIT · Synced On: Feb 26, 2026 UTC · Size: 4.0 KB · Lines: 161 · Encoding: UTF-8 · Line Endings: LF

View: Specification · Example · on GitHub ↗

developer-ai.txt

Enhancement Conditional
Propose a change

Version: 1.0.0 · Source: GenerellAI/ai-discovery-files · License: MIT · Synced On: Feb 26, 2026 UTC · Size: 5.4 KB · Lines: 185 · Encoding: UTF-8 · Line Endings: LF

View: Specification · Example · on GitHub ↗