Specification Version 1.7.0
Published
Last Modified
Status Stable

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

Abstract

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:

FilePurpose
brand.txtHow to correctly name and describe us
identity.jsonFactual identity data (name, locations, identifiers)
ai.txtHow 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

PropertyRequirement
EncodingUTF-8 (required)
Line endingsLF (Unix-style) recommended; CRLF accepted
SyntaxStructured plain text with section headers
CommentsLines 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

SectionDescriptionStatus
[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

SectionDescriptionStatus
[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

SectionDescriptionStatus
[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.json if present

Common Errors

ErrorResolution
Missing required sectionAdd all three required sections
Empty sectionsAdd at least one entry per section
Inconsistent with identity.jsonEnsure official names match
Vague naming rulesUse specific, actionable rules

§6 Relationship to Other Files

Related AI Discovery Files

FileRelationship
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 in identity.json alternateNames
  • The primary name SHOULD match identity.json name 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

See Also

For complete conflict resolution rules, see the Interoperability Guide.

§7 Canonical Example

The following example demonstrates a complete brand.txt file:

Complete Example
# 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:

  1. Update brand.txt with new names/rules
  2. Update identity.json alternateNames
  3. Verify llms.txt uses official naming
  4. 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

1.7.0

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.

1.6.0

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.

1.5.0

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.

1.4.0

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.

1.3.0

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.

1.2.0

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.

1.1.1

Added AI Visibility Directory registration guidance. Minor documentation update.

1.1.0

Added expanded optional sections (taglines, boilerplate, social-handles) and Content Not Permitted guidance. Clarifies what content SHOULD NOT appear in brand.txt files.

1.0.0

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".
Free WordPress Plugin

Generate AI Discovery Files from your dashboard

Using WordPress? Install the plugin and create all 10 files in minutes — no coding, no configuration files to edit manually.

Get the Plugin

Register in the AI Visibility Directory

Once your AI Discovery Files are published, register your website in the AI Visibility Directory — the verified registry of websites implementing AI Discovery Files. Registration validates your implementation and lists your site for AI systems and industry peers to discover.

Basic Listing

Card entry in the directory with automated file validation. Open to any site with a valid llms.txt file. No cost.

Full Listing Recommended

Dedicated profile page on the directory with dofollow backlinks to your website — a genuine SEO authority signal from a topically relevant, verified source. Includes an attribution badge and enhanced visibility.