Visibility
Brands and sub-brands
Settings → Brands: your brand and competitors, suggested competitors, social accounts, what an alias is, and how a sub-brand rolls up into its family.

What this screen shows
Open Settings → Brands (https://app.discoveredby.ai/settings/brands). It is where every brand the platform recognises for this project is set up: your own brand first, then a Competitors section with one card per tracked competitor, then Suggested competitors, the brands your answers name that you do not track yet, and last a collapsed Removed competitors list. Each brand shows its aliases, the other names mention extraction accepts as it, and below that its sub-brands
(api/routers/brand_aliases.py#list_brand_entities). A competitor's card also carries its domain, a See insights link to its Brand insights, its Rename, Pause or Resume, and Remove buttons, and its social accounts. A paused competitor is labelled "Paused: not counted in any metric, nor are its sub-brands." A paused competitor with no brand family behind it yet (families are created only for active competitors) has a smaller card with no aliases or sub-brands: its domain, Resume, Remove and its social accounts. A removed competitor is not labelled Paused: it appears read-only in the Removed competitors list, name and aliases only, with no controls, since it cannot be resumed the way a paused one can. Any current project member can read this screen; adding, renaming, pausing, removing, archiving or restoring anything needs company member or editor access.
There is no separate Competitors screen. You manage competitors here and compare yourself with them on Overview's Brand ranking and on Brand insights. An old link to the Competitors screen still works: it opens Overview, or, when it was a link to add a competitor, this screen with the add dialog open, carrying the filter bar's selection with it (frontend/src/lib/competitors.js#competitorsRedirect).
Add, rename, pause and remove

Under your own brand, the Competitors section has one card per tracked
competitor: its names and sub-brands, as described below, its
social accounts, and under its name its favicon, its
domain, See insights, which opens its
Brand insights, and Rename,
Pause or Resume, and Remove
(frontend/src/lib/components/brands/CompetitorControls.svelte#insightsHref).
The section's heading counts the project's active competitors against what
the company's plan allows and names the plan; it shows no count when the
plan sets no limit, and on a plan without competitor tracking it says the
plan does not include it
(frontend/src/lib/brand-suggestions.js#competitorCapText). Any current
project member can read the screen. Adding, renaming, pausing, resuming and
removing need company member or editor access; a viewer sees the buttons
disabled.
A competitor with no brand family behind it, which can happen to a paused
one because families are created only for active competitors, has a
smaller card: its name, favicon and domain, the label "Paused: not counted
in any metric." while it is paused, Pause or Resume and Remove,
and its social accounts. It has no names, no sub-brands, no Rename and
no See insights, since there is no brand family to show
(frontend/src/lib/brand-suggestions.js#competitorsWithoutFamily). Resuming
it creates its family, and the full card takes its place, unless another
brand took its name while it had none: then resuming is refused, the card
says why and it stays paused, so rename it first
(api/routers/competitors.py#_refuse_resume_into_a_taken_name).
Add competitor opens a dialog that asks for the competitor's domain and,
optionally, a display name, which otherwise defaults to the domain. The
command palette's Add competitor opens the same dialog. Your own domain
is refused, and so is a domain the project already tracks or a name that
another brand in the project already answers to; adding the domain
of a paused competitor resumes it instead
(api/routers/competitors.py#add_competitor). Left blank, the name stays
as it was; a different name renames the competitor the way Rename below
does, and a name another brand in the project already answers to is
refused before anything changes, so the competitor stays paused. Tracking a
competitor uses one of the competitor slots on the company's plan; a paused
competitor does not use one. See Pricing for what each plan includes
(api/services/limits.py#check_competitor_limit,
api/services/limits.py#active_competitor_count). When the slots are full,
Add competitor is disabled and the section says "Limit reached on this
company's plan." before you try, with a link that takes a company member to
the company's plans and offers anyone else a way to ask a company member to
upgrade (frontend/src/lib/upgrade.js#upgradeTarget).
Rename opens Edit competitor, where the domain is fixed and only the
display name changes. A new name relabels the competitor everywhere it is
shown, Overview, Brand insights, the Explorer and the prompt page included,
without
changing what is counted: the old name stays recognised as one of its
names, and the new name becomes one too, so past untracked mentions of
exactly the new name now count for it. The confirmation says how many past
mentions moved, when any did (api/routers/competitors.py#_rename,
api/services/brand_families.py#add_alias). A name that another brand in
the project already answers to, your own brand, another competitor or a
sub-brand of either, paused and archived ones included, is refused with a
message naming that brand, and nothing changes
(api/services/brand_families.py#refuse_another_brands_name).
Pause stops counting a competitor without losing it, and frees its slot;
the card stays, labelled "Paused: not counted in any metric, nor are its
sub-brands." Resume counts it again. Resuming when the plan's competitor
slots are full, or (for a competitor with no family yet) when its name is
taken, is refused: the card shows the reason in place and stays
paused (api/routers/competitors.py#update_competitor,
frontend/src/lib/components/brands/CompetitorControls.svelte#toggleError).
What pausing changes in your figures is under
Tracked versus untracked. A paused competitor
keeps its See insights link, and its Brand insights page says it is
paused.
Remove asks first, in a dialog that says the competitor stops being
tracked, that the answers already credited to it are not restored if you add
it again later, and that pausing it instead keeps its history. A removed
competitor moves to a collapsed Removed competitors list at the bottom
of the screen, read-only, with the note "Removed. Its past mentions are
kept." (api/routers/competitors.py#remove_competitor).
Social accounts
Each competitor's card ends with Social accounts: the Reddit, YouTube,
LinkedIn, review-site and other social accounts your team has recorded for
that competitor, each with its network and a link. Any project member can
read them. Company members and editors can add one by its URL, up to ten
per competitor, and remove one; a submitted URL that does not parse to a
recognised account is refused, and the same account cannot be added twice,
whether it would duplicate another competitor's account or one of the
project's own (api/services/social_sources/profiles.py#add_profile,
api/schemas/social_sources.py#MAX_COMPETITOR_SOCIAL_PROFILES). A refused
add shows its reason in the card, and when one competitor's accounts cannot
be loaded, only that card's list says so
(frontend/src/routes/(app)/settings/brands/+page.server.js#loadSocialProfiles).
These accounts exist to label that competitor's citations on Social sources, which is a separate screen: nothing here is compared against your own figures. Only an active competitor's accounts label anything; pausing a competitor stops them being labelled until it is resumed, and the card says so. Your own brand's card does not list your accounts: they are kept in Project settings, where company members manage them, and the card links there.
Suggested competitors
Under the competitor cards, Suggested competitors lists brands that the
answers to your prompts name and that you do not track yet: names found in
at least two answers over the last 28 days, ending yesterday, on any engine,
the 50 found in the most answers
(frontend/src/lib/brand-suggestions.js#SUGGESTION_MIN_ANSWERS,
#SUGGESTION_DAYS, #SUGGESTION_LIMIT,
api/routers/untracked_brands.py#list_untracked_brands,
api/routers/untracked_brands.py#_query_untracked). Every brand mention
comes from the same mention extraction that decides whether an answer named
you (see Key terms for mention versus citation).
Companies show by default, and only the answers that recorded the name as a
company count toward that list. Show all kinds switches to a second list
read the same way over every kind, with its own top 50: companies, products,
technologies, other kinds and names recorded with no kind, shown as
Unclassified (frontend/src/lib/brand-suggestions.js#suggestionsQuery). The
caption under the heading says what the list on screen counts, as in
"Companies named in at least 2 answers in the last 28 days that you do not
track yet.", and adds "Only the top 50 are shown." when that list came back
with 50 rows, since a full list may have left names out; when a list could
not be loaded, the caption says so instead
(frontend/src/lib/brand-suggestions.js#suggestionsCaption). One name in
different capitalisation is one row, shown in the spelling the answers used
most. Each row gives the kind, how many answers named it, and the first day
it was seen inside the 28 days.
Each row has three controls. A company member or editor can use all three; a viewer sees Track and Reject disabled and no More menu:
- Track opens the add dialog with the name filled in. Type the competitor's domain, since a suggestion has none. It is disabled while the plan's competitor slots are full.
- Reject takes the name off the list; see Rejecting a suggestion.
- More holds Add as a name of…, which adds the name to an existing
top-level brand, your own or a competitor's, paused ones included, and
Add as sub-brand of…, which nests it under an active one, offered
when sub-brands are available on
the company's plan. Either one moves any of the project's past untracked
mentions with exactly that name onto that brand. A removed competitor is
offered by neither: it has nothing left to take a new name
(
frontend/src/lib/components/brands/BrandSuggestions.svelte#shown).
Rejecting a suggestion
Reject is a judgement about what to suggest, not about what the answers
said. It hides that name, ignoring capitalisation, from this project's
suggestions, and stops future "New brand appearing in your answers" alerts
for it; an alert already raised for the name stays as it is
(api/routers/brand_suggestions.py#create_dismissal,
api/services/untracked_brands.py#not_rejected,
api/services/brand_signals.py#detect_emerging_brands). It changes no
measurement: the brand stays untracked, as it was, and
Prompt coverage and a prompt's Brands tab
still count and list it.
Rejected names wait under a collapsed Rejected list with their count,
each with Restore, which lets it be suggested, and alerted on, again
(api/routers/brand_suggestions.py#delete_dismissal). Rejecting a name
never stops you tracking it later with Add competitor.
Tracked versus untracked
Nothing on the suggestions list is tracked yet. An untracked brand's mentions are left out of every metric that counts brand mentions until you track it.
Adding a competitor (api/routers/competitors.py#add_competitor) records
its domain against your project and creates a matching brand entity at once
(api/services/brand_mentions.py#sync_brand_entities_for_project), so the
next answer naming that brand resolves to it instead of staying untracked.
Answers you already have are credited too: mention extraction matched names
against the brands you tracked when each answer was analysed, so an answer
from before you tracked a competitor holds its name as an untracked mention,
and adding the competitor points those mentions at it
(api/routers/competitors.py#_credit_past_mentions). Resuming a paused
competitor does the same. Removing a competitor is different: the answers
already credited to it stay attached to the removed brand, so they no longer
appear as tracked or untracked, and re-adding the competitor credits only
the answers analysed since the removal; it does not restore the ones
credited before. Only the competitor's own name is matched, exactly and
ignoring case; a competitor added by domain alone, whose name defaults to
the domain, moves nothing, and an answer that already names it under another
spelling keeps one row. From then on its mentions count by name and its
citations by its domain.
Tracked is not the same as active. Pausing a competitor keeps its card and
its history, but takes its brand family out of every brand figure, because
those count active brand families only: it leaves Overview's Brand ranking
and the Explorer's brand rows, and it leaves the totals that share of voice
and Citation share divide by, so the shares that remain still divide among
the brands shown (see
Pausing or removing a competitor).
Its Brand insights
shows an en dash for its brand figures, but its domain's Cited needs no
brand, so that is still measured
(api/services/brand_page.py#build_brand_page). Pausing
updates the brand roster in the same save, so the very next load already
leaves the brand out (api/routers/competitors.py#update_competitor,
#_sync_brands). A paused competitor also leaves the roster handed to
future mention extraction: an answer naming it after that point is recorded
unresolved rather than credited to it, the same as a brand you never
tracked.
What an alias is
An alias is another name for a brand. What recognises it depends where: for a new answer, every alias you save is handed to the extraction model as another name for that brand, and it is the model's own judgment, not a fixed rule, that decides whether a name in the answer refers to it
(api/services/brand_mentions.py#roster_entry). Re-attributing a project's past untracked mentions (see What happens to history, below) and cited-page matching both work differently: they search for an exact, case-insensitive name instead, the cited-page search matching the family's names as whole words in the saved text
(api/services/source_mentions.py#alias_pattern). Every alias is typed as one of five kinds, for your own reference: Brand name, Product name, Abbreviation, Common misspelling or Domain (api/schemas/brand_alias.py#BrandAliasCreate); every type is treated the same way everywhere. There is no regex or pattern alias, anywhere an exact match is used.
Sub-brands
A sub-brand is a second brand nested one level under a top-level brand, your own or a tracked competitor's. You can add a sub-brand under your own brand and under any active tracked competitor; a sub-brand cannot itself have sub-brands, so nesting stops at one level
(api/services/brand_families.py#create_sub_brand). Sub-brands are available on Starter, Growth and Pro; on Free and Trial the existing sub-brands, if any, are still shown, but the controls to add or restore one are replaced by an upgrade note. A brand can hold up to 10 active sub-brands, and a project up to 50 active sub-brands in total across every brand and competitor combined
(api/services/brand_families.py#MAX_SUB_BRANDS_PER_BRAND, #MAX_SUB_BRANDS_PER_PROJECT).
The once-per-answer rule
A brand family, a top-level brand plus its sub-brands, counts once per answer in share of voice, your own visibility and position, no matter how many of the family's names appear together in that answer. An answer naming both Acme and its sub-brand Acme Pay is one answer for the Acme family, never two
(api/services/explorer/metrics.py#_share_of_voice_statement). Position rolls up the same way: when an answer names more than one family member, the family's position for that answer is whichever of them was named earliest. This changes only how a family is counted as a whole; an answer that names no sub-brand is counted exactly as it was before sub-brands existed, and a project with no sub-brands at all sees identical figures to before.
What a sub-brand reports on its own
Each active sub-brand also reports its own sentiment on Sentiment trends, as an indented row under its family
(api/services/sentiment_trends.py#sentiment_trends_for_project). Its family's Brand insights lists each active sub-brand with the answers that named it and that count as a share of the family's answers, under every filter (api/services/brand_page.py#_sub_brands). Those figures overlap each other and the parent's own figures rather than adding up to them, because one answer can name the parent and a sub-brand, or two different sub-brands, at once. Both screens say this next to their sub-brand rows.
Where a sub-brand counts as its parent
Cited-page matching never breaks a sub-brand out on its own. Brand evidence inside cited pages, that evidence's saved detail, what an engine retrieved before answering, and whether a prompt is classified as naming a tracked brand all build their brand list from each family's full set of names, so a sub-brand's names count there as its parent being present
(api/services/brand_families.py#family_roots). A sub-brand appears as its own row on Sentiment trends and on its family's Brand insights and, named in a parent_brand column, in the Brand mentions export.
What happens to history
Adding a name, a new alias or a new sub-brand, checks the project's past untracked mentions (names the platform saw in an answer but had not matched to any tracked brand) for an exact, case-insensitive match, and moves the matching rows onto the new name; the app reports how many moved
(api/services/brand_families.py#reattribute_untracked). Creating a sub-brand whose name already exists as one of its own parent's aliases moves that alias, and the past mention rows that used it, onto the new sub-brand instead of creating a duplicate name; the family's own totals are unchanged by this move, since those rows simply shift from counting as the parent to counting as the sub-brand within the same family. None of this re-runs extraction or calls a model against old answers: it only reattaches rows that were already stored.
Re-attribution moves at most one row per answer onto the new name, never two: an answer can already hold a row for the brand under a different name, so a separate untracked row spelled exactly like the new alias is deliberately left where it is rather than merged in. That leftover row stops appearing among the suggested competitors on this screen all the same, the moment its name matches a display name or alias held by your own brand or a current, active or paused, competitor, or either one's sub-brand, in the project, whether or not that particular row actually moved. A name held only by a removed competitor, or one of its sub-brands, is the one exception: mention extraction never matches a removed brand, so a fresh untracked row spelled like one keeps showing here, or there would be no way back to track it again
(api/routers/untracked_brands.py#_query_untracked).
Archiving a sub-brand stops it being recognised in new answers, but its past mention rows stay counted in the family: the family's own visibility, share of voice and sentiment total are unaffected, because the family total always included it. An archived sub-brand is listed under Archived rather than as an active row, and can be restored later, subject to the same caps and name checks as creating one
(api/services/brand_families.py#archive_sub_brand, #restore_sub_brand). Its display name and every one of its aliases stay reserved for as long as it is archived: within the family, nothing else, not even a brand-new sub-brand, can take one of those names, so restore the archived sub-brand instead of trying to recreate it.
Adding, re-adding or resuming a competitor runs the same re-attribution for the competitor's own name, and renaming one runs it for the new name; see Tracked versus untracked.
Managing brands and sub-brands
From Settings → Brands, a company member or editor can add or remove an alias on any brand or sub-brand, add a sub-brand under a top-level brand, and archive or restore one. A name answers for one brand only: adding an alias, a sub-brand or a competitor under a name that your own brand, another competitor, or a sub-brand of either already answers to, paused and archived ones included, is refused with a message naming that brand, and nothing changes. A removed competitor's names are free again
(api/services/brand_families.py#refuse_another_brands_name). The automatic names a new competitor gets, its display name and its bare domain label, follow the same rule: a domain label another brand already answers to is left out rather than shared, and a competitor added during setup, where its name comes from its domain and cannot be edited, takes its full domain as its name when another brand already answers to the shorter one. Resuming a paused competitor that has no brand family yet is refused when another brand took its name in the meantime
(api/services/brand_mentions.py#_add_entity, api/routers/projects.py#create_onboarding_project, api/routers/competitors.py#_refuse_resume_into_a_taken_name). A suggested competitor's More menu offers Add as a name of…, which adds the name as an alias of your brand or a competitor, and, where sub-brands are available, Add as sub-brand of…, beside Track and Reject. A sub-brand's own name alias cannot be removed, since it is what mention extraction still needs in order to recognise it
(api/routers/brand_aliases.py#remove_alias). Neither picker offers a removed competitor as a destination: it has nothing left to attach a new name to, so trying to add one directly is refused
(api/services/brand_families.py#add_alias).
What is not included
There is no regex or pattern alias, only an exact, case-insensitive name, anywhere an exact match is used (see What an alias is, above). Sub-brands nest one level only: a sub-brand cannot itself have sub-brands. A sub-brand cannot be reparented to a different brand or renamed; archive it and create a replacement instead. The Brand position metric is a whole family's: in each answer, the earliest family member named. There is no separate Brand position for a sub-brand. Overview's brand ranking shows it for you and for each active tracked competitor (api/services/overview.py#_ranking), and the Explorer reports it by brand family. The Brand mentions export is a different thing: its mention_order column records where each mention fell within its own answer, one value per row, for every brand and sub-brand, not only your own.
Access
Any current project member can read this screen. Adding or removing an alias on a top-level brand needs company member or editor access on every plan, with no plan gate. Adding a sub-brand, restoring an archived one, and adding an alias to an active sub-brand all additionally need the company's plan to include sub-brands: standard Starter, Growth and Pro
(api/services/brand_families.py#hierarchy_available). An archived sub-brand's own alias list is frozen until it is restored: add a name to an active sub-brand, or restore an archived one first
(api/services/brand_families.py#add_alias). Archiving a sub-brand stays open on every plan, and so does removing an alias, other than a sub-brand's own name, which can never be removed at all
(api/services/brand_families.py#archive_sub_brand). So a project that has moved off a qualifying plan can still tidy up even though it cannot add, restore, or add a name to a sub-brand. The app only surfaces this for an active sub-brand: Settings → Brands collapses an archived sub-brand to just its name, with a Restore button for company members and editors on a plan that includes sub-brands, and no alias list and no remove control either way, so its aliases are effectively frozen there until you restore it.
Related
- Brand insights: one brand, yours or a competitor's, beside you under every filter, and where you compare yourself with your competitors
- Reading your first results: Overview's Brand ranking of you and your competitors
- Social sources: where a competitor's social accounts label its citations
- Alerts: when a "New brand appearing in your answers" alert fires
- Key terms: what separates a mention from a citation
- Sentiment trends: where sub-brand rows appear in the brand comparison, trend and evidence pickers
- Metrics defined: the share-of-voice formula a brand family rolls up into
- Plans and limits: the company's plan is what controls a plan-gated feature like this one
Last verified 2026-11-02