The brand identity registry is the definitive record of every name and domain that counts as your brand in AI assistant responses. It is the direct input for presence scoring.
Why presence is deterministic
When the platform processes an AI answer, it checks for your brand's presence using a fixed algorithm: search the answer text for any registered name, and check the citations list for any registered domain. If a match is found, the answer is marked as a mention. If not, the answer is marked absent.
This check does not use an LLM judge. It does not vary between scans. The same answer text checked against the same registry always returns the same result. This is intentional: it makes your mention rate reproducible, auditable, and independent of model variation.
What the registry contains
The registry for each product has four parts.
Primary brand name. Derived from your brand profile. This is always active and shown with a green label.
Auto-derived variants. The classifier automatically builds a set of variants from your brand name: capitalisation variants, abbreviations, joined forms. These are shown with an "auto" label. They are matched at classify time without any manual configuration.
Configured aliases. Name variations you have explicitly added. Short forms, app names, common informal names, trading names, and abbreviations that users and AI assistants actually use in text. Up to 24 entries.
Additional domains. Domains beyond your primary domain where your brand appears in citations: app subdomains, country-specific versions, older domains, or microsites. Up to 12 entries.
Where to find the registry
The registry is visible and editable in two places:
-
Brand Truth page (
/app/products/{id}/truth). The identity block at the top shows all registry entries and the edit form. This is the main management surface. -
Onboarding review screen. During guided onboarding, each product has a collapsible identity block in the review screen. You can finalise the registry before launching baseline scans. Saving from here does the same thing as saving from Brand Truth.
AI-suggested variations
On live-onboarded products, you can request LLM-proposed name variations. Use the "Suggest variations with AI" link on the Brand Truth page or the onboarding review screen. The LLM is prompted to list name forms real users and AI assistants actually use, considering short forms, abbreviations, app names, and common informal usage in your market context.
Suggestions are stored separately and shown in an amber panel. They are never applied automatically. Copy the ones that genuinely represent your brand into the name variations box and save. The suggestion panel does not reappear for entries you have already added.
Saving registry changes
The edit form has two text areas: one for name variations (one per line or comma-separated) and one for additional domains (bare hostnames, one per line). Click "Save identity" to commit. New scans measure against the updated registry immediately.
Saving does not affect past scan results. Historical answers retain whatever mention state they had when the scan ran.
Re-applying to past scans
After adding a new name or domain, use the "Re-apply to past scans" button to run a retroactive evidence pass over your entire scan history for the product.
The re-tag operation: - Finds every answer that was marked absent in past scans for this product. - Checks each absent answer against the updated registry. - Upgrades answers that now match to "mentioned." - Rebuilds the metric summaries and recommendation rates for every affected scan.
No AI calls are made. No credits are used. The operation runs synchronously and reports back how many answers were reclassified and across how many scans.
This means a registry change can both improve your current measurements (new scans) and correct your historical baseline (re-tag pass). The practical effect is that your real mention rate at past dates becomes more accurate if the registry was previously incomplete.
What the registry does not cover
The registry handles presence (was your brand named or cited?). It does not control how AI evaluates or ranks your product after it is named. Recommendation rate, sentiment, and accuracy are scored by the LLM judge on answers where you were already present. Registry completeness affects how many answers are in scope for those scores, but not the scores themselves.
Related docs
Questions
What happens to my mention rate if I add a new name to the registry?
New scans will count answers that use the new name as mentions. To also update your historical rates, use "Re-apply to past scans." This re-checks all previously-absent answers against the updated registry and upgrades matches to mentioned, then rebuilds your historical metrics.
Why is presence scored deterministically and not by an LLM?
Deterministic matching makes the metric reproducible. The same answer checked twice always returns the same result. An LLM-based presence check would vary with model version and prompt phrasing, making your trend line unreliable. The presence floor is fixed; quality scoring (how good is the mention?) uses the LLM judge only after presence is established.
How are auto-derived variants different from configured aliases?
Auto-derived variants are computed from your brand name by the classifier and cannot be edited. Configured aliases are variants you add manually. Both are checked at score time. Auto-derived variants are meant to catch the most obvious forms; configured aliases handle anything the auto-derivation misses.
Can I add a competitor's domain to my registry by mistake?
You can add any string to the registry. Adding a competitor domain would cause their citations to count as your mentions, inflating your mention rate. Only add domains you own and where you want citations credited to your brand.
Does the re-apply operation change recommendation rate or sentiment?
If re-tagging upgrades an absent answer to mentioned, that answer is now in the pool for further scoring. If the answer also contained a recommendation or had sentiment data, those metrics are recalculated in the rebuilt summary. The net effect depends on the quality of the newly-credited answers.
Is there an audit trail for registry changes?
Yes. Every save to the identity registry and every re-tag operation is recorded in the workspace activity log (/app/workspace/activity), including who made the change, when, and how many aliases and domains were saved.
What is the maximum registry size?
Up to 24 name aliases and 12 additional domains per product. Names must be at least 2 characters. The registry normalises case when checking for duplicates, so "ABCD" and "abcd" are treated as the same entry.
AI Native