Brando::Representing Brand-as-Code
Brand Oracle (Brando) Vocabulary v1.3
Brando® – the Brand Oracle — is a proposed linked-data standard and Brand Directive Vocabulary (BDV). It models brand identity, expression, governance, and product/persona structures as machine-actionable semantics, providing an ontological layer that LLMs, agents, and multimodal systems can interpret, enforce, and perform with precision.

Why Brando exists
Advanced Analytica has been pioneering the use of Schema.org and JSON-LD (Schema Markup) as a control layer for LLMs and generative AI. Our research into foundation model training and inference showed that JSON-LD is an AI-native, graph-based representation that models interpret reliably, making it a natural fit for encoding brand rules and constraints and enforcing them as a controlled, policy-aware brand oracle at runtime.
Brando, short for Brand Oracle, is a formal extension of Schema.org from a descriptive SEO layer into an AI-native operative layer for generative and agentic systems. Instead of replacing existing Schema Markup, Brando reuses and extends it – minimising rework, accelerating implementation, and simplifying internal adoption. If your sites already publish Schema Markup, you already have the substrate that Brando turns into Brand-as-Code.
This site documents the latest version of the Brando Vocabulary v1.3:
- the JSON-LD vocabulary under the
brando:namespace, - the Brand Directive Vocabulary (BDV) patterns used at runtime,
- the YAML profile for configuration and ops,
- and reference integration patterns for Brand Operating Systems (Brand OS), RAG pipelines, and agent runtimes.
Brando is designed to be both:
- an open vocabulary and ontology, and
- the schema layer for Machine-Actionable Policy Graphs that AI runtimes can execute in a Brand Operating System.
What is Brando?
Schema.org defines what things are — the entities in your world:
products, brands, audiences, articles, places, actions.
It is primarily a descriptive vocabulary: it helps machines recognise and index entities.
GS1 Web Vocabulary extends this descriptive layer for commerce: trade items, locations, parties, logistics, and supply chain attributes.
Brando sits one layer up as a Brand Directive Vocabulary (BDV):
- where Schema.org and GS1 describe facts about things,
- Brando BDV encodes how the brand expects systems to behave around those things.
In other words:
- Schema.org / GS1 → descriptive layer (“what this product/brand is”).
- Brando BDV → directive layer (“how any AI or agent must speak and act about it”).
Brando is:
- a linked data vocabulary and ontology for brands (JSON-LD, Schema.org extension),
- a Brand Directive Vocabulary (BDV) that encodes tone, language, constraints, guard rails, personas, and automation rules, and
- a taxonomy / control layer for brand and product categories aligned with GS1, UNSPSC, and Google Product Taxonomy.
Brando lives at:
- Namespace:
https://brandoschema.com/ - Preferred prefix:
brando
It:
- extends
schema:Brandandschema:Intangible, - aligns cleanly with GS1 Web Vocabulary for products, brands, GTINs and GLNs,
- is published canonically in JSON-LD, and
- is profiled for YAML configuration and TypeScript types.
You can:
- embed Brando JSON-LD in public sites for AI and web discovery,
- manage Brando YAML in repositories as configuration for a Brand Operating System (Brand OS), or
- load Brando instances into a Brand Policy Graph that powers multiple runtimes with the right runtime architecture, execute Brando instances as Machine-Actionable Policy Graphs that direct how AI systems behave.
Internally, we talk about Brando as:
Brando BDV – the Brand Directive Vocabulary that tells AI systems what a product or brand is, and how they are allowed to talk, reason, and act in relation to it.
What this documentation covers
Use the navigation, or jump directly into:
- Getting started – motivation, core ideas, and how to adopt Brando incrementally.
- Quickstart (JSON-LD) – minimal JSON-LD examples for a brand, context, personas, and policies.
- Quickstart (YAML) – YAML profile for teams that treat Brando as configuration.
- Types reference – definitions of
brando:Brand,brando:Context, expression tokens, personas, policies, campaigns, and rules. - Properties reference – domains, ranges, and usage notes for all
brando:properties. - Brand Operating System – how Brando underpins a Brand OS and Brand Knowledge Graph.
- Runtime integration (LLMs, MCP, APIs) – how to use Brando at inference time.
- JSON-LD context and YAML profile – implementation details and constraints.
- Examples – worked examples for brands, portfolios, personas, and runtime flows.
Brando in practice: from vocabulary to Policy Graph
The Brando vocabulary is designed to be used as the schema layer for:
- Brand Knowledge Graphs – modelling brands, contexts, tokens, personas, and policies as linked data;
- Machine-Actionable Policy Graphs – encoding governance logic (what AI may / must / must not do) as data, not prose;
- Brand Operating Systems – AI-native runtimes where LLMs, agents, and workflows query the Policy Graph and BDV at inference time.
Advanced Analytica’s Brando Implementation Service uses this vocabulary to:
- map brand strategy and governance into Brando classes,
- author JSON-LD / YAML Policy Graphs and BDV instances,
- and deploy them as a live AI-native Brand OS.
For implementation details, see:
Brando as a brand vocabulary for AI
Traditional brand governance is built around static, human-only artefacts:
- PDF guidelines and slide decks,
- brand portals and DAM folders,
- unstructured “system prompts” and playbooks for AI.
These do not translate cleanly into probabilistic systems like LLMs and agents.
The Brando vocabulary applies linked data and semantic web patterns to brand governance:
- reusing JSON-LD and Schema.org patterns, and aligning where useful with GS1 product and brand descriptions,
- modelling brand intent, rules, personas, and tokens as data (not prose),
- and using that data as a control layer that AI runtimes can load, combine, and enforce.
Foundation models are heavily trained on JSON-LD and Schema.org–style structures.
Brando reuses this structure so that models can interpret brando: classes and properties zero-shot, without custom training.
Why AI has to help manage the Brand Policy Graph
A Brando-based Brand Policy Graph is intended to be living:
- brands, products, and portfolios change,
- channels and surfaces proliferate,
- policies evolve with regulation and risk.
At any meaningful scale – multiple brands, markets, campaigns, and channels – maintaining this graph purely by hand becomes prohibitively hard:
- too many contexts (
brando:Context) to keep in sync, - too many tokens (
Brando:VerbalIdentity,Brando:VisualIdentity,Brando:AudioIdentity) to update, - too many personas (
brando:SyntheticPersona,brando:ProductPersona) to govern, - too many policies (
brando:Policy,brando:AutomationRule) to refactor as requirements change.
Brando is therefore AI-manageable by design:
- the vocabulary is compact, with clear domains and ranges, so agents can propose changes (e.g. new contexts, updated tokens, refined personas) in JSON-LD or YAML;
- LLMs can generate schema-conformant Brando data zero-shot because the structure mirrors Schema.org and linked data patterns;
- properties like
brando:reviewWorkflow,brando:enforcementLevel, andbrando:riskTagsupport human-in-the-loop governance, not bypass it.
In practice:
People define intent and governance.
AI does the mechanical work of keeping the Brand Policy Graph up to date, under auditable human control.
Advanced Analytica designs and iterates Brando with this AI-manageable governance model in mind, treating the vocabulary as a long-term, evolving asset for brands.
Core concepts and classes
Brando v1.3 defines twelve core classes under the brando: namespace:
| Class | Informal purpose |
|---|---|
brando:Brand |
Core brand identity node extended with governance, architecture, and AI-ready semantics. |
brando:Context |
Activation context describing audience, channel, jurisdiction, and operational conditions. |
brando:BrandExpression |
Abstract superclass for reusable expression tokens across verbal, visual, and audio modalities. |
Brando:VerbalIdentity |
Reusable configuration of the brand’s voice, language, and behavioural prompt rules. |
Brando:VisualIdentity |
Reusable configuration of visual system: logo, colour, typography, imagery, and motion. |
Brando:AudioIdentity |
Reusable configuration of sonic identity: voice, sonic logos, and audio cues. |
brando:Policy |
Governance node for guard rails, refusals, compliance tags, and retrieval visibility. |
brando:BrandedCategory |
Brand-specific product/service category aligned with GS1, UNSPSC, and Google Product Taxonomy. |
brando:Campaign |
Time-bound campaign that may temporarily adjust brand rules. |
brando:AutomationRule |
Automated governance rule reacting to metrics or events to adjust brand behaviour. |
brando:ProductPersona |
Product-scoped AI persona aligned with schema:Product / schema:Brand / schema:Organisation and GS1 identifiers for that product. |
brando:SyntheticPersona |
Governed AI persona type encoding identity, tone, competencies, constraints, and policy bindings aligned with schema:Product / schema:Brand / schema:Organisation . |
All Brando classes ultimately extend schema:Intangible, and brando:Brand additionally extends schema:Brand and can be related to GS1 brand/product concepts in implementation profiles via schema:Product.
High-level relationships
Key structural properties include:
-
brando:hasContext
–brando:Brand → brando:Context(activation contexts in which the brand operates) -
brando:usesVerbalIdentity/brando:usesVisualIdentity/brando:usesAudioIdentity
–brando:Brandorbrando:Context →expression tokens for different modalities -
brando:hasPolicy/brando:hasAutomationRule
– attach governance and automation to brands and contexts -
brando:hasProductCategory
–brando:Brand → brando:BrandedCategorynodes with GS1/UNSPSC/Google mappings -
brando:hasSyntheticPersona/brando:hasProductPersona
– connect brands and products to their governed AI personas
See Types reference and Properties reference for normative definitions (domains, ranges, comments).
Canonical form and implementation profiles
Brando is JSON-LD–first:
- the JSON-LD vocabulary defines all classes, properties, and metadata (publisher, license, version info);
- implementations are encouraged to publish JSON-LD on the public web where possible.
Two implementation profiles are documented:
- JSON-LD profile
For:
- public publication on brand domains,
- ingest into knowledge-graph platforms,
- direct consumption by AI runtimes.
See:
- JSON-LD context
-
YAML profile
Same semantics, represented as YAML, suitable for:
- configuration repositories,
- CI/CD pipelines,
- infrastructure-as-brand setups.
See:
A TypeScript model is provided as a non-normative convenience layer for strongly-typed implementations
(see TypeScript types).
Example: minimal brand + context in JSON-LD
The example below shows a small Brando graph using canonical JSON-LD:
{
"@context": {
"schema": "https://schema.org/",
"brando": "https://brandoschema.com/"
},
"@id": "https://example.com/brand/northstar",
"@type": "brando:Brand",
"schema:name": "Northstar Bank",
"brando:missionStatement": "Financial clarity with absolute trust.",
"brando:coreValues": [
"Clarity over complexity",
"Do the right thing",
"Long-term alignment with customers"
],
"brando:hasContext": {
"@id": "https://example.com/brand/northstar/context/retail-chatbot",
"@type": "brando:Context",
"brando:audienceSegment": "Retail banking customers",
"brando:domainContext": "{\"channel\":\"chatbot\",\"jurisdiction\":\"UK\",\"productLine\":\"current-accounts\"}"
},
"brando:usesVerbalIdentity": {
"@id": "https://example.com/brand/northstar/tokens/verbal/default",
"@type": "Brando:VerbalIdentity",
"brando:toneOfVoice": "calm, empathetic, and precise",
"brando:approvedTerms": [
"interest rate",
"fees",
"savings goals"
],
"brando:prohibitedTerms": [
"guaranteed returns",
"get rich quick"
]
},
"brando:hasPolicy": {
"@id": "https://example.com/brand/northstar/policies/regulated-claims",
"@type": "brando:Policy",
"brando:enforcementLevel": "mandatory",
"brando:riskTag": [
"financial-regulation",
"consumer-protection"
],
"brando:refusalStrategies": [
"Decline to provide personalised investment advice.",
"Redirect to a human advisor for complex suitability questions."
]
}
}
The same structure can be authored as YAML using the Brando YAML profile, then emitted as JSON-LD at build or deployment time.
The example below shows a small Brando graph using YAML:
@context:
schema: https://schema.org/
brando: https://brandoschema.com/
@id: https://example.com/brand/northstar
@type: brando:Brand
schema:name: Northstar Bank
brando:missionStatement: Financial clarity with absolute trust.
brando:coreValues:
- Clarity over complexity
- Do the right thing
- Long-term alignment with customers
brando:hasContext:
@id: https://example.com/brand/northstar/context/retail-chatbot
@type: brando:Context
brando:audienceSegment: Retail banking customers
brando:domainContext: '{"channel":"chatbot","jurisdiction":"UK","productLine":"current-accounts"}'
brando:usesVerbalIdentity:
@id: https://example.com/brand/northstar/tokens/verbal/default
@type: Brando:VerbalIdentity
brando:toneOfVoice: calm, empathetic, and precise
brando:approvedTerms:
- interest rate
- fees
- savings goals
brando:prohibitedTerms:
- guaranteed returns
- get rich quick
brando:hasPolicy:
@id: https://example.com/brand/northstar/policies/regulated-claims
@type: brando:Policy
brando:enforcementLevel: mandatory
brando:riskTag:
- financial-regulation
- consumer-protection
brando:refusalStrategies:
- Decline to provide personalised investment advice.
- Redirect to a human advisor for complex suitability questions.
Brando in a Brand Operating System
Brando is designed to act as the data and ontology layer for a Brand Operating System:
Identity & architecture
Model house-of-brands, branded houses, and hybrids with multiple brando:Brand nodes and properties such as:
brando:brandArchitectureRolebrando:inheritsPoliciesbrando:inheritsTokens
Context-aware behaviour
Use brando:Context to represent channels, audiences, regulatory regimes, and operational conditions that change how the brand behaves.
Multimodal expression tokens
Attach Brando:VerbalIdentity, Brando:VisualIdentity, and Brando:AudioIdentity to brands and contexts using:
brando:usesVerbalIdentitybrando:usesVisualIdentitybrando:usesAudioIdentity
Personas and product-linked assistants
Use:
brando:SyntheticPersonafor governed, cross-surface AI personas, andbrando:ProductPersonafor GTIN/GLN-scoped assistants that speak for specific products or ranges,
linking them back to brands, products, contexts, and policies via brando:hasSyntheticPersona, brando:hasProductPersona, and brando:appliesToProduct.
Governance and lifecycle
Encode rules and risk in brando:Policy and brando:AutomationRule with:
brando:enforcementLevel(e.g."mandatory","advisory","conditional"),brando:riskTag,brando:reviewWorkflow,- plus temporal metadata (
dcterms:created,dcterms:modified, optionallyschema:validFrom/schema:validThroughin instance data).
Runtime automation and integrations
Use:
brando:AutomationRule,brando:triggerType,brando:automationAction,brando:schedulingRulefor automated checks and behaviours;brando:externalSystemandbrando:externalSystemIdto connect Brando nodes to external applications such as brand management platforms, content and design tools, ad platforms, CMS/DXP systems, and internal line-of-business tools;brando:downloadableFileandbrando:supportingFileto point AI systems at the right assets in a DAM or Brand OS.
For architecture and runtime patterns, see:
Classification alignment
brando:BrandedCategory nodes provide a bridge between a brand’s own taxonomy and external standards.
Relevant properties include:
-
brando:gpcCategoryCode/brando:gpcCategoryDescription– GS1 Global Product Classification (GPC), -
brando:unspscCode– UNSPSC category identifiers, -
brando:googleProductCategoryId– Google Product Taxonomy identifiers.
This lets you:
- keep brand-facing labels and semantics in your own language,
- while exposing machine-readable hooks to GS1 / UNSPSC / Google for commerce, ads, and marketplaces.
See also Brand portfolios & architecture for portfolio- and category-level modelling patterns.
Versioning and licensing
From the vocabulary header (owl:Ontology):
- Title:
Brando Schema Vocabulary v1.3 - Namespace (prefix):
brando: → https://brandoschema.com/ - Ontology version info:
owl:versionInfo = "1.4" - Created:
dcterms:created = "2025-11-22" - Modified:
dcterms:modified = "2025-11-22" - Publisher:
Advanced Analytica - License: CC BY 4.0 via
cc:license
Implementations should treat:
- the JSON-LD vocabulary file and
- this documentation set
as the normative reference for Brando Schema Vocabulary v1.3.
Any “future ideas” or experimental patterns mentioned in the docs are explicitly labelled as:
- non-normative guidance, or
- potential future extensions, or
- profile-level recommendations,
and are not part of the core v1.3 vocabulary.
Stewardship and support
Brando is originated, owned, and stewarded by Advanced Analytica.
Advanced Analytica:
- defines and maintains the core Brando vocabulary,
- publishes the reference JSON-LD and YAML profiles,
- and leads ongoing research, design, and innovation around Brand OS patterns and AI-native brand governance.
The intent is to:
- keep the core vocabulary stable and minimal,
- allow organisations and platforms to define extensions for their own needs,
- and evolve the spec in collaboration with brands, agencies, and technology providers.
For information about stewardship, trademark usage, and terms, see:
From vocabulary to running Brand OS
Brando is designed to be used, not just read.
Most teams follow a simple spec → graph → runtime path:
-
Model with the Brando vocabulary
- Define
brando:Brand,brando:Context, expression tokens, personas, and policies. - Start with JSON-LD or YAML using the official profiles.
- Define
-
Build a Machine-Actionable Policy Graph
- Load Brando instances into a Brand Knowledge Graph or config repo.
- Attach policies, campaigns, personas, and categories to the right brands and contexts.
-
Integrate at runtime
- Expose the Policy Graph and BDV to LLMs, agents, and APIs.
- Use it as the control layer that governs prompts, retrieval, generation, and approvals.
-
Monitor and evolve
- Treat the graph as a living asset: update products, contexts, personas, and rules as the brand changes.
- Use AI to propose structured changes, with humans approving and merging.
For many organisations this journey is incremental: start with a single brand and use case, then extend to portfolios, campaigns, automation rules, and product-level personas.
Implementation support (optional)
Brando is an open vocabulary: you can adopt it independently using this documentation.
If you want a fully managed path from brand book to Brand OS, Advanced Analytica offers the Brando Implementation Service, covering:
- mapping strategy and governance into Brando classes and BDV patterns,
- authoring JSON-LD / YAML Machine-Actionable Policy Graphs and personas,
- deploying them as a live Brand Operating System for your AI stack.
Learn more at:
Next steps
If you are evaluating or implementing Brando:
Step 1. Read the overview
Step 2. Clone a minimal example
Step 3. Choose your primary representation
Step 4. Model your first brand, context, and persona
brando:Brandbrando:ContextBrando:VerbalIdentitybrando:SyntheticPersonabrando:Policy
Step 5. Plan your Brand OS integration
From there, extend into portfolios, campaigns, product personas, automation rules, and classification alignment – all grounded in the same Brando vocabulary and managed as a living, AI-assisted Brand Policy Graph.