Skip to main content

Open in AthenaHQ

app.athenahq.ai/competitors

Purpose

The Competitors page is where you manage the list of competing brands you want to track across AI responses. By defining specific competitors, their website domains, and identifying keywords, you instruct the system on how to accurately detect and measure Share of Voice (SOV) for both your brand and your rivals. Beyond simply listing known competitors, this page actively helps you uncover new ones. The system analyzes AI responses to surface unknown brands that frequently appear alongside your tracked keywords, allowing you to discover and begin tracking emerging competitor threats with a single click. Any changes made to competitor tracking rules (like adding a new brand, updating keywords, or adjusting domains) can be retrospectively applied to past data. This ensures your historical analytics remain perfectly aligned with your current competitive landscape.

What’s on the page

Tab Navigation Allows you to switch between three different views:
  • Tracked competitors: Your active list of competitors (and your own brand) being monitored.
  • Discovered competitors: Auto-generated suggestions of new brands frequently mentioned in AI responses.
  • Deleted: Only visible if you have previously removed competitors. Contains a historical list of soft-deleted entries.
Identifier Suggestions Bar When the AI detects new keywords or spellings that likely refer to a tracked brand, this bar appears above the Tracked table. It displays pending suggestions so you can quickly review and accept or dismiss them. Tracked Competitors Table The primary table listing your brand (always labeled “(You)”) and all active competitors.
  • (checkbox): Row selection checkbox for bulk actions. Supports shift-click range selection.
  • Name: Company logo and display name of the competitor.
  • Website: The competitor’s primary URL. Clicking the URL copies it, and an external link icon opens it in a new tab.
  • Identifiers: Keywords used to detect this brand.
    • Tooltip: “We use these keywords to identify your brand in AI responses”
  • Domains: Website domains used to track citations.
    • Tooltip: “Domains used for citation tracking. Supports wildcards (e.g. *.acme.com)”
  • Added on: The date the competitor was created (MM/DD/YYYY). If the competitor has an audit history, this date acts as a clickable link to view changes over time.
  • Actions: A three-dot (⋯) menu containing row-specific actions.
Discovered Competitors Table Shown on the “Discovered competitors” tab. Lists candidates automatically found in your AI response data.
  • Competitor: Logo, display name, and root domain with an external link.
  • Mention %:
    • Tooltip: “Percentage of AI responses that mention this competitor”
  • Mentions:
    • Tooltip: “Total number of times this competitor was mentioned across all responses”
  • Mentioned in:
    • Tooltip: “Unique responses mentioning this competitor out of total analyzed”
  • Last seen: The most recent date this competitor was detected in an AI response.
  • Actions: Displays an “Add” button to begin tracking the candidate, or a checkmark “Added” indicator if they are already tracked.
Drilldown (Response Details): Expanding a row in the Discovered table reveals evidence snippets. Clicking an evidence row opens the Response Details Drawer, showing the full AI response text with the matched competitor highlighted, alongside metadata like the date, model, and prompt type. Deleted Competitors Table Shown on the “Deleted” tab. Lists soft-deleted competitors.
  • Name: Logo and display name of the deleted competitor.
  • Website: The competitor’s URL with an external link icon.
  • Actions: A “Restore” button to re-activate the competitor.
Change Queue Bar (Command Bar) A fixed bar at the bottom of the screen that only appears when you have pending changes (like adding a competitor, updating an identifier, or adding a domain). It tallies your pending edits and allows you to backfill those rule changes across historical data. Bulk Selection Command Bar Appears at the bottom of the screen when one or more rows are selected in the Tracked table, replacing the Change Queue Bar temporarily. It provides bulk actions for the selected rows.

What you can do here

Top-Level Actions
  • Add Competitor: Opens the Add Competitor drawer. Here, you can:
    • Add a single competitor by entering their URL and name.
    • Bulk-add multiple competitors by pasting a list of names or URLs.
    • Import a CSV file to upload a large list of competitors at once.
Own Website Row Actions (⋯ Menu) Your own brand (labeled “You”) has a slightly different action menu:
  • Edit: Opens the Edit Company Name drawer to rename your brand and optionally add the new name as a tracking identifier.
  • Manage domains: Opens a drawer to add or remove citation-tracking domains, including wildcard patterns (e.g., *.acme.com).
Inline Table Actions
  • Manage Identifiers: Clicking an “Identifiers” pill opens a popover to add new identifiers, edit existing ones inline, or remove them.
  • Manage Domains: Clicking a “Domains” pill opens a popover to add or remove domains.
  • View History: Clicking a hyperlinked “Added on” date opens the Competitor History Drawer, showing a timeline of audit log events (renames, identifier changes) for that competitor.
Identifier Suggestions Bar Actions
  • Add: Accepts a suggested AI-detected identifier and applies it to the brand.
  • Dismiss: Ignores the suggestion so it no longer appears.
  • Review all: Opens a modal listing all pending identifier suggestions for the active competitor, allowing you to bulk-process them.
Discovered & Deleted Tab Actions
  • Add (Discovered tab): Immediately moves an AI-suggested candidate into your tracked competitors list.
  • Restore (Deleted tab): Brings a soft-deleted competitor back to the Tracked list. Confirmation: “Restore [name] to your tracked competitors? It will be included in future tracking.”
Change Queue Bar Actions
  • View Changes: Opens a dialog listing every pending rule change. From here, you can Undo a specific data change, Skip (discard) a queue entry, or Skip all to clear the queue entirely.
  • Backfill: Applies all pending changes in the queue and triggers a background reanalysis of past AI responses for the selected date range. Deducts credits based on the number of responses analyzed.
Bulk Command Bar Actions (Visible when rows selected)
  • Delete: Soft-deletes all selected competitors at once. Confirmation: “Are you sure you want to delete N competitors? You can restore them later from the deleted competitors section.”
  • Export: Downloads a CSV file containing the Name, URL, and Identifiers of the selected competitors.
  • Reset: Clears the current row selection.

Data shown

The Tracked tab displays competitors, domains, and keywords configured by your team. The Discovered tab populates by continuously scanning your AI response data for unfamiliar brands that frequently appear near your tracked keywords. The Deleted tab pulls from soft-deleted records in the database. The history drawer reads directly from the platform’s audit logs. Company logos are automatically fetched from a centralized CDN based on the competitor’s website domain.

Common workflows

Add a single competitor
  1. Click the “Add Competitor” button in the top right.
  2. Enter the competitor’s website URL (an autocomplete dropdown will suggest matching companies).
  3. Enter or confirm the competitor’s name.
  4. Click “Add” to save.
  5. The competitor appears in the Tracked table, and a new entry is added to the Change Queue Bar.
Bulk-add competitors by name
  1. Click the “Add Competitor” button.
  2. Switch to the “Multiple” tab at the top of the drawer.
  3. Select the “By name” mode.
  4. Type or paste competitor names separated by commas or newlines.
  5. Click “Preview” to let the system look up the companies and generate recommended identifiers.
  6. Review the preview list, edit any names, URLs, or identifiers as needed, and remove any unwanted entries.
  7. Click “Add N competitors” to save them all.
Import competitors from CSV
  1. Click the “Add Competitor” button.
  2. Switch to the “Multiple” tab.
  3. Click “Download Template” to get the required CSV format (Name, URL, Identifiers columns).
  4. Upload your filled-in CSV file.
  5. Review the preview list with AI-generated identifiers.
  6. Click “Add N competitors” to save them all.
Backfill past responses after competitor changes
  1. Make changes to competitors, identifiers, or domains. Each change will silently queue at the bottom of the screen in the Change Queue Bar.
  2. (Optional) Click “View Changes” to review, undo, or skip individual changes.
  3. Select a date range in the Change Queue Bar to define how far back you want to re-analyze.
  4. Click “Backfill” (a badge will show how many credits this operation will cost).
  5. Confirm the operation. A background workflow will reanalyze all responses in that date range.
Discover and add a competitor from AI responses
  1. Navigate to the “Discovered competitors” tab.
  2. Review the table of candidates, sorted by their mention rate.
  3. Expand a row to see evidence snippets from actual AI responses where this brand was found.
  4. Click an evidence row to open the full response in the Response Details drawer to verify the context.
  5. Click the “Add” button on the desired candidate to instantly track it as a competitor.

Empty, loading, and error states

  • Empty states:
    • If no website is selected globally, the page displays: “Please select a website to view its competitors”.
    • If the Tracked tab has no data, the table shows “No results.”
    • The Discovered tab shows “No discovered competitors yet” if no candidates are found.
    • The Deleted tab shows “No deleted competitors” if none exist.
  • Loading states: The table displays a centered animated spinner while competitor data is fetching. The Discovered and Deleted sections also feature centered spinners during loading.
  • Error states: Individual actions (like failing to update identifiers or delete a competitor) trigger red toast notifications in the corner of the screen. If you attempt a backfill without an active subscription or sufficient credits, the Change Queue Bar will show a toast indicating “Insufficient credits” or “Active subscription required.”

Common support questions

Why can’t I delete my own company? Your own brand (labeled “(You)”) acts as the anchor for all Share of Voice metrics. It cannot be deleted from the bulk command bar or via row actions. If you need to stop tracking it, you must pause or delete the entire website from the global settings. Why is the “Backfill” button disabled? The Backfill button requires an active subscription plan and sufficient credits to perform the reanalysis. The system charges 1 credit per 100 responses in the selected date range. If you do not have enough credits or your subscription is inactive, the button is disabled. How do I remove the default identifier? You cannot remove a competitor’s default identifiers (usually their exact company name and root domain). The system enforces a minimum of 1 identifier per competitor to ensure tracking functions properly. Where did my deleted competitor go? When you delete a competitor, it is “soft-deleted” and moved to the “Deleted” tab. You can navigate to that tab and click “Restore” to bring them back into your active tracking list without losing historical data.