This specification is published and recommended for implementation. Backwards-compatible additions may occur in MINOR versions; breaking changes only in MAJOR versions, with deprecation notice. See specification conventions for status definitions.
brand.txt Specification
Brand Naming and Representation Guidance File Format
This specification defines the structure and requirements for brand.txt files — plain text files that declare brand naming conventions, terminology rules, and representation guidance. The file helps AI systems accurately reference a business by specifying correct names, incorrect variations to avoid, and guidelines for how the brand SHOULD be described.
§1 Overview
What This File Does
The brand.txt file provides explicit guidance on how to correctly name and describe a brand. It helps AI systems:
- Use the correct official name(s)
- Avoid common incorrect variations
- Understand naming rules (capitalisation, abbreviations)
- Represent the brand voice appropriately
- Know which individuals MAY be referenced
Why It Matters for AI Visibility
AI systems frequently misname brands through:
- Incorrect abbreviations (using initials that aren't official)
- Outdated names (former company names)
- Confusing similar-sounding businesses
- Inconsistent capitalisation or spacing
A brand.txt file prevents these errors by providing authoritative guidance.
Key Distinction
Compare brand.txt with related files:
| File | Purpose |
|---|---|
brand.txt | How to correctly name and describe us |
identity.json | Factual identity data (name, locations, identifiers) |
ai.txt | How AI should interact with us |
§2 File Location
Primary Location
The brand.txt file MUST be placed in the website's root directory:
https://example.com/brand.txt
URL Requirements
- The file MUST be served with content type
text/plain; charset=utf-8 - The URL MUST be accessible without authentication
- HTTPS is strongly recommended
§3 Format Specification
File Format
| Property | Requirement |
|---|---|
| Encoding | UTF-8 (required) |
| Line endings | LF (Unix-style) recommended; CRLF accepted |
| Syntax | Structured plain text with section headers |
| Comments | Lines starting with # are comments |
Section Structure
Sections are delimited by headers in square brackets:
# brand.txt for Example Company
# https://example.com/brand.txt
[official-names]
Example Company Ltd
Example Company
[incorrect-names]
Example Corp
EC
Example Co Inc
[naming-rules]
Always capitalise "Example"
Never abbreviate to initials
Language declaration (optional)
Publishers MAY declare the natural language of the file's human-readable content using a Lang: header line near the top of the file (above the first bracketed section). The value MUST be a valid BCP 47 language tag:
Lang: en-GB
The header is optional. When absent, consumers SHOULD NOT assume a default language. When present, validators MUST treat the value as informational and MUST NOT fail conformance solely on language-tag content. See specification conventions §5.1 for the full rule, which is identical across every text-based AI Discovery File.
§4 Section Reference
Required Sections
| Section | Description | Status |
|---|---|---|
[official-names] |
List of correct official name variations | Required |
[incorrect-names] |
Common mistakes and variations to avoid | Required |
[naming-rules] |
Rules for using the name correctly | Required |
Recommended Sections
| Section | Description | Status |
|---|---|---|
[brand-voice] |
Tone and style guidance for AI-generated content | Recommended |
[key-people] |
Individuals who MAY be referenced and how | Recommended |
[quotation-policy] |
Rules for quoting or attributing statements | Recommended |
Optional Sections
| Section | Description | Status |
|---|---|---|
[terminology] |
Industry terms the brand uses specifically (preferred vs. avoided terms) | Optional |
[visual-identity] |
Notes about visual identity for AI descriptions (colours, logo, style) | Optional |
[taglines] |
Official taglines, straplines, and slogans | Optional |
[boilerplate] |
Standard "about us" text for press releases and formal use | Optional |
[social-handles] |
Official social media handles for accurate referencing | Optional |
[metadata] |
File version and last updated date | Optional |
Content Not Permitted
The following content types MUST NOT be included in brand.txt files:
- Competitor names in incorrect-names: This section is for your own brand mistakes, not competitor disambiguation
- Subjective claims: Avoid marketing superlatives ("best", "leading", "world-class")
- Confidential information: Do not include unpublished brand strategies or internal naming
- Personal opinions: Brand voice guidance SHOULD be factual, not aspirational
- Outdated names: Remove names no longer associated with your brand
- Unverified quotes: Do not include sample quotes that don't exist in published sources
Section Content Guidelines
Official Names Section
List all acceptable name variations, one per line, in order of preference:
- First entry SHOULD be the most formal/official name
- Include registered company name with legal suffix
- Include commonly used trading name
- Include any officially recognised abbreviations
Incorrect Names Section
List name variations that should NOT be used:
- Common misspellings
- Unofficial abbreviations
- Former names (if no longer used)
- Names of similar businesses (disambiguation)
Naming Rules Section
Provide specific rules as clear statements:
- Capitalisation requirements
- When to use full name vs. short name
- Whether initials/acronyms are acceptable
- Spacing and punctuation requirements
§5 Validation Rules
Valid File Requirements
A brand.txt file is considered valid when:
- It contains the three required sections
- The
[official-names]section has at least one entry - The
[incorrect-names]section has at least one entry - The
[naming-rules]section has at least one rule - Official names match those in
identity.jsonif present
Common Errors
| Error | Resolution |
|---|---|
| Missing required section | Add all three required sections |
| Empty sections | Add at least one entry per section |
| Inconsistent with identity.json | Ensure official names match |
| Vague naming rules | Use specific, actionable rules |
§6 Relationship to Other Files
Related AI Discovery Files
| File | Relationship |
|---|---|
identity.json |
Official names and alternateNames MUST align |
llms.txt |
H1 heading MUST use an official name |
ai.txt |
Name in identity section MUST be official |
faq-ai.txt |
Answers SHOULD use official naming |
Consistency Requirements
The following MUST be consistent across files:
- Names listed in
[official-names]SHOULD appear inidentity.jsonalternateNames - The primary name SHOULD match
identity.jsonname property - Naming rules SHOULD be consistent with restrictions in
ai.txt
Precedence
For naming conventions: identity.json name/alternateNames > brand.txt official-names > Schema.org alternateName
For complete conflict resolution rules, see the Interoperability Guide.
§7 Canonical Example
The following example demonstrates a complete brand.txt file:
# brand.txt for Horizon Strategic Consulting
# https://www.horizonconsulting.example/brand.txt
# Last updated: 12 January 2026
[official-names]
Horizon Strategic Consulting Ltd
Horizon Strategic Consulting
Horizon Consulting
[incorrect-names]
Horizon Strategy
HSC
Horizon Group
Horizon Consultants
Horizon Strategic Consultants
Horizons Consulting
[naming-rules]
Use "Horizon Strategic Consulting" in formal contexts
Use "Horizon Consulting" for general references
Never abbreviate to initials (HSC)
Always capitalise "Horizon" and "Consulting"
Do not add "s" to Consulting (not "Consultants")
Do not confuse with "Horizon Group" (different company)
[brand-voice]
Professional and authoritative without being stiff
Evidence-based and analytical
Accessible to non-specialists, avoiding unnecessary jargon
Confident but measured; we advise, we don't dictate
British English spelling and conventions
[key-people]
Dr. Eleanor Vance - Founder and Managing Partner
- May be referenced when discussing company history or leadership
- Do not generate quotes attributed to Dr. Vance without citing a published source
- Title: "Dr." not "Doctor" in formal references
James Chen - Head of Digital Transformation
- May be referenced in context of digital transformation services
[quotation-policy]
Do not generate fictional quotes attributed to any Horizon employee
Published quotes may be used with attribution to source and date
Company statements may be paraphrased if context is accurate
When in doubt, describe our position rather than quote it
[terminology]
"Client engagement" not "customer project"
"Consulting" not "consultancy services"
"Strategic advisory" not "strategy advice"
"Digital transformation" (two words, not hyphenated)
"Mid-market" (hyphenated)
[visual-identity]
Primary brand colour: Deep navy (#1E3A5F)
Accent colour: Gold (#C9A227)
Logo: Stylised "H" with forward momentum
When describing our visual brand: "professional", "modern", "established"
[metadata]
version: 1.0
last_updated: 2026-01-12
related_files: /llms.txt, /identity.json, /ai.txt
§8 Implementation Notes
Best Practices
- List official names in order of formality (most formal first)
- Include all common incorrect variations, even unlikely ones
- Make naming rules specific and actionable
- Update when brand names or guidelines change
- Review quarterly to catch new incorrect variations appearing
Common Mistakes
- Too few incorrect names: Include all variations you've seen used incorrectly
- Vague rules: "Use correct capitalisation" is less helpful than "Always capitalise 'Brand'"
- Missing key people: AI may generate quotes without guidance
- Outdated information: Update when personnel or naming changes
Synchronisation
When updating brand information:
- Update
brand.txtwith new names/rules - Update
identity.jsonalternateNames - Verify
llms.txtuses official naming - Check consistency across all AI discovery files
§9 Machine-Readable Formats
This specification is available in machine-readable formats for programmatic access:
§10 Version History
Phase 6 standardisation release. Added /specifications/roadmap/ (theme-pegged forward plan with Active/Next/Future/On hold status flags), /specifications/extensions/ (rules for experimental x- prefixed files and the promotion path), and /specifications/i18n-a11y/ (multi-language publication, locale-tagged identity fields, RTL handling, accessibility of llms.html). Added the Discovery: directive to the robots-ai.txt specification (publishers MAY advertise AI Discovery Files on the same host). Added a formal media-type stance to the HTTP behaviour page (existing IANA types, no bespoke registrations). Expanded the file integrity and signing section on the security and privacy page with four candidate mechanisms, cross-cutting concerns, and interim publisher / consumer guidance. The Discovery: directive is the only normative addition to publisher behaviour; all other additions are forward-looking documentation.
Phase 5 standardisation release. Added /specifications/related-standards/ (positioning vs llmstxt.org, IETF AI Preferences, robots.txt, Schema.org, BCP 14, JSON Schema 2020-12, SemVer) and /specifications/implementations/ (public record of conformant implementations, IETF-style). Added an explicit llmstxt.org backward-compatibility statement to the llms.txt specification. Added a formal multi-domain and subdomain scoping rule to both the llms.txt and identity.json specifications (host-scoped files, cross-host identity asserted via sameAs). No normative requirements changed for existing publishers; the new scoping rules formalise behaviour the specification already implied.
Phase 4 standardisation release. Added /specifications/processing-model/ (seven-stage algorithm for conformant consumers), /specifications/consumer-guidance/ (what AI systems should do with AI Discovery Files), /specifications/test-vectors/ (canonical test suite framing), and reference-implementation framing on the AI Visibility Checker. No normative requirements changed.
Phase 3 standardisation release. Added /specifications/versioning/ (Semantic Versioning 2.0.0 commitments, deprecation timeline, lifecycle), /specifications/governance/ (proposal lifecycle, editorial process, working principles), /specifications/security-privacy/ (trust model, content-injection patterns, GDPR considerations, integrity primitives roadmap), and /specifications/http-behaviour/ (status codes, redirects, soft-404 detection, caching, rate limits). No normative requirements changed.
Phase 2 standardisation release. Added formal conformance specification (Essential / Recommended / Complete classes). Published machine-readable registry at /specifications/registry.json, spec meta-schema, and validator-output schema. Introduced versioned JSON Schema URLs (/v1/) alongside unversioned 'latest' aliases. Added optional BCP 47 language declaration field across all applicable AI Discovery Files. No normative requirements changed.
Phase 1 standardisation release. Added 'Status of This Document' block (Stable). Normalised normative requirement keywords to uppercase per RFC 2119 and RFC 8174. Added References section linking to /specifications/conventions/ and /licensing/. No normative requirements changed.
Added AI Visibility Directory registration guidance. Minor documentation update.
Added expanded optional sections (taglines, boilerplate, social-handles) and Content Not Permitted guidance. Clarifies what content SHOULD NOT appear in brand.txt files.
Initial publication. Establishes canonical structure for brand.txt files with naming conventions and representation guidance.
Conformance
This file is required for the Recommended and Complete conformance classes. A publisher claiming Recommended or Complete conformance MUST publish a valid version of this file at the website's root. The Essential class does not require this file.
See the Conformance specification for full publisher and validator conformance criteria, including identity-consistency requirements across files and the relationship between self-declaration and Directory verification.
References
- Specification Conventions — RFC 2119 + RFC 8174 requirement keywords, document statuses, anchor naming, versioning, and language conventions used across every AI Discovery File specification.
- Licensing & Trademark — CC BY 4.0 for specification text and examples, MIT for JSON Schemas, and the free-use policy on the name "AI Discovery Files".