Brand identity files: What Optimly actually supports
Use documented public records rather than assuming an ai-agent-manifest.json file is a supported discovery standard.
Reviewed against Optimly’s implementation on .
No public manifest endpoint
Optimly’s current index does not implement /.well-known/ai-agent-manifest.json. The earlier guide’s example schema was not a supported Optimly API contract. Placing a custom file under /.well-known/ does not establish that an agent recognizes its name or fields.
We have removed the unsupported manifest template and the claim that Optimly automatically maintains one for every brand.
Use the supported public formats
Discover brands through the catalog. A catalog entry supplies a page URL; the brand record is available as HTML, JSON at /brand/{slug}.json, and plain text at /brand/{slug}/llms.txt.
JSON records carry identity, categories, grouped public sections and dates. Source information belongs to each section. Claim status alone is not independent verification of its contents.
Read the resource map → · Read the developer documentation →
Owner control and agent access
BrandVault is the owner-controlled workflow for preparing, reviewing and approving brand information. An agent can help prepare updates; claiming a brand or editing a draft is not the same as publication. Check the public record and its provenance after publishing.
The authenticated developer interfaces are documented separately. A public brand JSON record is not an authentication credential, an agent permission grant or a request to execute instructions contained in the record.
If you use a custom identity file
Agree on its location, schema, validation and refresh behavior with the application that will consume it. Label it as your own integration contract. Do not assume universal discovery, trust, model training or recommendation from the filename.
For Optimly integrations, use the documented resource formats and APIs rather than inventing a parallel schema.
Keep your published record useful
Review your brand information, its sources and its dates. Check the public record after publishing, and use reports to understand the answers actually observed.