brand.json is a structured JSON file that describes key brand information as a machine-readable brand profile: name, positioning, tonalityDefinition of Tone of Voice The tone of voice (in German, tone of voice or brand voice) describes the characteristic language style and the way in which... Click to learn moreServices, target groups, languages, evidence, and official profiles are stored in such a way that websites, AI assistantsAn "AI assistant" is a digital application that uses artificial intelligence to support and independently complete tasks, processes, or communication. Unlike conventional digital tools, it learns... Click to learn more, AutomationsAutomation is the execution of recurring tasks and rule-based processes by software, systems, or machines, ensuring that a process continues reliably without constant manual intervention. The... Click to learn more and teams can use the same brand base.
For SMEs, brand.json is useful when brand knowledge shouldn't just be stored in a PDF, in people's heads, or in scattered website texts. In my work with small businesses, I often see the same problem: The brand has been clearly conceived, but in practice, web designers interpret it differently. TexterThe role of a copywriter can be clearly summarized: A copywriter is a copywriter who writes texts with a specific goal, such as generating more inquiries, clicks, etc. Click to learn moreSocial media managers, translators, and AI tools interpret the same information differently.
A brand.json file can reduce this friction if the brand strategy has been defined beforehand. You can also think of the file as a Brand Data File or an AI-driven brand profile: it makes key brand information available in a structured way, but it doesn't replace strategic brand work.
A brand.json file doesn't make a brand strong. A brand.json file makes an already defined brand technically unambiguous and usable.
brand.json: Definition and purpose
A brand.json file is a voluntary, structured brand file in JSON format. According to the RFC Editor, JSON is a lightweight, text-based data interchange format, normatively described in RFC 8259. Its benefit lies not in the file name itself, but in its clear structure: machines can read fields, compare, update, and transfer the data to other systems.
In practice, brand.json becomes a kind of Single Source of Truth for digital Brand managementBrand management is the conscious, long-term control of your brand through strategy, behavior, communication, and customer experience. Brand management ensures that your positioning is not only effective on the... Click to learn moreThe file does not answer every strategic question, but it does record the agreed-upon answers in one central location. This makes the brand identityDefinition of Brand Identity Brand identity refers to the totality of recognition elements and corporate values that make a brand unique and distinguish it from... Click to learn more not reinterpreted with every website extension, every content production, or every AI workflow.
What information belongs in a brand.json file?
A good brand.json file isn't necessarily the longest, but the most unambiguous. For an SME, a few well-maintained fields are often sufficient. The important thing is that the information is verifiable, up-to-date, and usable.
- Brand Name: The public name under which your company operates.
- Legal name: the official company name, if the company name differs from the brand name.
- Claim or short sentence: The condensed statement of what your brand stands for.
- Short description: A clear description in 1 to 3 sentences that people and systems can understand.
- Services: The most important offers with understandable names, not just internal product names.
- Target groups: the customer groups for whom your offer is actually intended.
- Tonality: linguistic guidelines such as factual, warm, direct, local, professional or advisory.
- Values and attitude: Key principles that shape decisions, communication, and collaboration.
- Proof Points: Verifiable trust signals such as locations, experience, specialization, references, certifications or real case studies.
- No-Gos: Wording, industries, promises or representations that do not fit the brand.
- Languages: Relevant language versions for multilingualism, such as German and Italian in South Tyrol.
- Contact and location: Official contact methods, addresses and geographical location.
- Social Profiles: official profiles on LinkedIn, Instagram, Facebook, YouTube or other channels.
- Links to Discovery files: References to supplementary files such as llmsLarge Language Models are large language models: A Large Language Model is a language model trained on very large text sets that calculates probabilities for words or tokens... Click to learn more.txt, Sitemap, Schema.org data, or API endpoints.
At Berger+Team, we never consider such structures in isolation. A brand.json file is most valuable when the brand file consists of a clean, uncluttered structure. Brand strategy and positioning is created and then linked to a website. ContentContent encompasses all intentionally published digital content on websites, in online shops, on social media channels, in newsletters, and in other digital environments. If you want to know more... Click to learn more, automation and AI processes work together.
Example structure of a brand.json file
A brand.json file can look different depending on the company. For a small company, I would usually divide the structure into sections that are immediately understandable even without a developer:
- identity: Brand nameDefinition of Brand: Brand (also called brands) is an English word for brand. A brand is a distinctive mark that identifies products or services... Click to learn more, legal name, claimDefinition of a slogan A slogan (also motto or slogans) is a concise motto of a brand or product that expresses the promise, identity, or... Click to learn more, Brief description, year of foundation and location.
- positioning: Target groups, value proposition, specialization and differentiation.
- voice: Tone, language rules, example sentences, and terms to be used or avoided.
- offers: Services, products, service areas and suitable descriptions.
- proof: Proof points, references, experience, certificates, press or verifiable trust signals.
- channels: Website, contact information, social profiles, review profiles and relevant platforms.
- languages: Language versions, translation logic, and regional peculiarities.
- governance: Responsible person, update date, version and source of the data.
The area governance It's more important than many companies realize. If no one is responsible for maintaining and updating the information, a good file quickly becomes an outdated data repository. Brand management requires responsibility, not just structure.
brand.json, Brand Style Guide, llms.txt and Schema.org: the difference
brand.json is often confused with other files or standards. Distinguishing it is important because each tool performs a different task.
- Brand Style Guide: A Brand Style Guide regulates visual and linguistic application for humans: White WaveDesign logoDefinition of a Logo: A logo (also known as a brand logo, product logo, company logo, or logotype) is the graphic representation of the name of a product, company, or organization. It... Click to learn more, Colors, typographyTypography is the deliberate design of typefaces, spacing, hierarchy, and readability in print and digital media. The English term "typography" means the same thing: typefaces are... Click to learn more, Image style, tone of voice and layout rules.
- llms.txt: The file llms.txt It provides AI systems with guidance on important website content. According to llmstxt.org, llms.txt is a suggested format for a Markdown file. /llms.txtLLMs.txt 2026 means, in short: The /llms.txt file is a voluntary guidance file for AI systems, agents, and other automated readers. The file is a community proposal, not an official one... Click to learn more, but not a ratified IETF or W3C web standard.
- Schema.org: Schema.org is a joint initiative for describing structured web data; according to Schema.org, the founding companies include Google, Microsoft, Yahoo and Yandex.
- brand.json: brand.json consolidates the brand identity into a data profile. The file describes not just a single website or piece of content, but the brand as a reusable digital unit.
If you generally deal with machine-readable website information, then this article is for you. structured data on the website A useful addition. Schema.org solves a different problem than brand.json, but both approaches follow the same basic idea: Important information should not only be visually represented, but also clearly interpretable.
When does brand.json bring real benefits to an SME?
brand.json isn't immediately worthwhile for every company. The file is particularly useful when multiple systems, people, or channels need to work with the same brand database.
- Website content: Recurring descriptions, service names, company data, and contact information remain more consistent.
- AI assistants: AI tools are given a clearer basis for texts, summaries, answers and internal workflows.
- Multilingualism: German-Italian or multilingual content can be better coordinated because key terms and tone are defined.
- Internal handovers: New employees, external copywriters, developers, or marketing partners have to do less guessing.
- Automation: Workflows can access verified brand data instead of gathering information from old documents or pages.
- Brand management: Changes to positioning, services, or official profiles can be managed more systematically.
Especially in small teams, the practical benefits are noticeable. Not because a file automates everything, but because less energy is spent on coordination, corrections, and misunderstandings. If you use such processes with KIArtificial intelligence is the umbrella term for digital systems that recognize patterns in data and take over tasks that would otherwise require human perception, assessment, or decision-making... Click to learn more or if you want to connect automation, brand.json belongs more in the area of AI and Digitalization than pure design documentation.
What brand.json cannot do
A brand.json file is not a substitute for strategy and does not guarantee a ranking. This distinction is important because many promises surrounding AI visibility are overly ambitious.
- brand.json does not replace a brand strategy: When positioning, target audienceDefinition of the target group A target group (also target group, target audience) is a specific group of people or buyer groups (such as consumers, potential customers, decision-makers, etc.)... Click to learn more And if the promised benefits are unclear, the file only stores the ambiguity.
- brand.json does not replace a Brand Style Guide: Design, visual rules, and concrete application examples still need a document for people.
- brand.json does not guarantee AI visibility: AI systems can process structured information better, but this does not guarantee a mention in ChatGPT. Gemini:Google Gemini is a powerful AI model series from Google and the successor to Google Bard. It is a multimodal AI system that can handle various input types... Click to learn more, Claude or Perplexity.
- brand.json does not replace a legal review: Company data, claims, certificates and legal information must be correct and approved.
- brand.json does not resolve content quality: If website texts are weak, interchangeable, or unsubstantiated, a structured file will not make the brand more credible.
AI is an amplifier, not a shortcut. If the brand is clear, brand.json can scale clarity. If the brand is unclear, brand.json only scales vagueness.
Checklist: What needs to be clarified before creating a brand.json file?
Before you have a brand.json file created, some basic questions should be answered clearly. This checklist is sufficient as an initial check for most SMEs.
- Who are you officially? Brand name, company name, location, contact details and responsible persons must be unambiguous.
- What do you stand for? Positioning, values and attitude must be specific enough so that the description does not sound interchangeable.
- Who do you work for? Target groups must be clearly described, including exclusions: For whom is your offer not intended?
- What do you offer? Services and products need understandable names, priorities, and short descriptions.
- How do you speak? Tone of voice, informal or formal address, technical language, regional peculiarities and no-gos must be clearly defined.
- What demonstrates your competence? Proof points should be verifiable: experience, projects, results, specialization, certificates or real references.
- Which channels are official? Websites, social media profiles, review platforms and other profiles must be managed consistently.
- Who maintains the file? Without accountability, every structured database loses value over time.
Decision-making aid: Is a Brand Style Guide sufficient, or do you need brand.json?
A classical Brand Style GuideA brand style guide is a binding working document that defines the visual and linguistic rules of your brand. The brand style guide defines how logo usage,... Click to learn more It's often sufficient if your brand is managed primarily internally, visually, and across a few channels. If logo, colors, ImageryVisual language is the consciously defined visual set of rules for a brand. Visual language determines how photos and images are used on a website, in social media, in recruitment... Click to learn moreFor many small businesses, having typography and tone clearly documented is a solid first step.
The brand.json file becomes useful when your brand is to be further processed digitally. This applies to websites with many content areas, multilingual communication, content production with AI assistants, automated sales processes, internal knowledge systems, or a website that is not just a surface but an operational foundation.
My rule of thumb: If your brand is defined by multiple people or systems, you need a machine-readable brand identity. If your brand is managed by only one person and a single design document, brand.json is probably not the first lever to pull.
How Berger+Team classifies brand.json
For Berger+Team, brand.json is not an isolated technical product. The file is a technical translation of what is in BrandingBranding is the conscious, strategic development of a brand. Branding determines how your company is perceived, what people recognize it by, and why they trust it. Click to learn more, Website, Content and DigitalizationDigitalization explained simply: Digitalization is the conversion of analog or manual processes into digital, traceable, and measurable processes. For SMEs, digitalization doesn't primarily mean new... Click to learn more This needs to be clearly defined anyway. Therefore, we don't start with the file itself, but with the questions behind it: positioning, target group, benefits, language, evidence, and system logic.
This perspective stems from my over 20 years of experience working with SMEs and from the work of Berger+Team, a freelance collective based in Bolzano. Small businesses don't need added complexity, but rather less coordination effort. A well-designed brand.json file can contribute precisely to this: less room for interpretation, clearer handoffs, and a brand that operates more consistently across digital platforms.
FAQ about brand.json
Is brand.json an official standard?
No, brand.json is not currently a generally ratified web standard like JSON itself. The term describes a sensible convention for a machine-readable brand profile, the value of which derives from clean structure, maintenance, and practical use.
Does every website need a brand.json file?
No, not every website needs a brand.json file right away. The file becomes useful when your website, content, AI assistants, translations, or automations are to operate from a consistent brand foundation.
Does brand.json help with ChatGPT or other AI assistants?
brand.json can provide AI assistants with clearer, more consistent brand information if the file is accessible and meaningfully integrated. However, brand.json does not guarantee visibility, citations, or recommendations in ChatGPT, Gemini, Claude, or Perplexity.
What is the difference between brand.json and Schema.org?
Schema.org describes structured dataWhat is structured data? Structured data refers to data that is organized in a standardized format so it can be easily interpreted by search engines and other... Click to learn more For individual website entities such as organizations, products, people, or events. In contrast, brand.json bundles the brand identity as a coherent data profile that can also be used for internal systems, content processes, and AI workflows.
What is the difference between brand.json and a Brand Style Guide?
A brand style guide explains to people how a brand is used visually and linguistically. brand.json translates key brand information into structured data so that systems, websites, and AI assistants can use the same foundation.
Can I create a brand.json file without a brand strategy?
Technically yes, but strategically I would advise against it. Without a clear brand strategy, a brand.json file quickly becomes a collection of superficial statements instead of a reliable single source of truth.
How often should a brand.json file be updated?
A brand.json file should always be updated when services, positioning, contact methods, social media profiles, languages, or key proof points change. Additionally, a brief review every 6 to 12 months is advisable to prevent the file from becoming outdated.
