Skip to main content

Open in AthenaHQ

app.athenahq.ai/competitors

​
Purpose

The Competitors page allows you to manage the tracked competitors, discovered competitor suggestions, and deleted competitors for your selected website. This page is where you configure the specific identifiers (keywords) and domains used for AI mention detection. By keeping your competitors and their identifiers up to date, you ensure that the AI search analytics accurately track and measure your brand’s performance against your actual market competition.

​
What’s on the page

Tab Navigation Switches the main view between three sections: Tracked competitors, Discovered competitors, and Deleted competitors. Note that the “Deleted” tab is only visible when you have previously deleted at least one competitor. Identifier Suggestions Bar Appears dynamically above the tracked competitors table when the system detects pending AI-generated identifier suggestions for your brand or tracked competitors. It allows you to quickly review, add, or dismiss these suggested keywords. Tracked Competitors Table Lists your own website (labeled as “(You)”) followed by all your actively tracked competitors. It provides quick access to their configurations, including identifiers and domains. Discovered Competitors Section Shows AI-discovered competitor candidates ranked by their mention rate. It includes evidence snippets so you can verify why a brand is being suggested before deciding to track it. Deleted Competitors Section Lists any soft-deleted competitors. You can view them here and optionally restore them to your tracked list. Change Queue Bar (Command Bar) Appears fixed at the bottom of the screen whenever there are pending identifier, domain, or competitor changes queued for backfill. It displays a summary of changes, a date range picker, and buttons to view changes or initiate the backfill process. Bulk Selection Command Bar Stacks at the bottom of the screen when one or more rows are selected in the tracked competitors table, providing bulk actions like Delete and Export.

​
Deleted Competitors Table

Lists soft-deleted competitors that can be restored.
  • Name: Company logo and display name of the deleted competitor.
  • Website: The competitor’s URL with an external link icon.
  • Actions: Restore button to bring the competitor back to tracked status.

​
Discovered Competitors Table

Shows AI-discovered competitor candidates with evidence of their mention frequency.
  • Competitor: Company logo, display name, and root domain of the discovered competitor candidate. This row is expandable to show evidence snippets.
  • Mention %: The percentage of analyzed AI responses that mention this competitor. Tooltip: “Percentage of AI responses that mention this competitor”
  • Mentions: Total count of times this competitor was mentioned across all responses. Tooltip: “Total number of times this competitor was mentioned across all responses”
  • Mentioned in: Number of unique responses mentioning this competitor out of total analyzed responses. Tooltip: “Unique responses mentioning this competitor out of total analyzed”
  • Last seen: The most recent date this competitor was seen in an AI response.
  • Actions: “Add” button to track this competitor, or an “Added” checkmark if they are already tracked.

​
Drilldowns

  • Click ‘Added on’ date (competitor row, when history exists): Opens the Competitor History Drawer, showing a timeline of audit log events for that competitor (identifier changes, renames, deletions, etc.) with actor name and timestamp.
  • Click evidence row in Discovered Competitors table: Opens the Response Drawer, showing full AI response details including the snippet that mentioned the discovered competitor.
  • Click ‘Add Competitor’ button: Opens the Add Competitor Drawer, containing a form to add a single competitor by URL/name, or bulk-import by name list, URL list, or CSV file with an identifier preview.
  • Click ‘Edit’ in competitor row action menu: Opens the Edit Competitor Drawer, allowing you to update the competitor’s name and URL, with optional identifier replacement checkboxes.
  • Click ‘Edit’ in own website row action menu: Opens the Edit Company Name Drawer to rename the website/brand with an option to add the new name as an identifier.
  • Click ‘Manage domains’ in own website row action menu: Opens the Manage Owned Domains Drawer, showing a list of owned domains with add/remove controls and wildcard pattern support.
  • Click ‘View Changes’ in Change Queue Bar: Opens the View Changes Dialog, displaying a grouped list of all queued changes (by competitor or website) with per-change undo buttons and an Undo all option.
  • Click ‘Review all’ in Identifier Suggestions Bar: Opens the Identifier Suggestions Review Modal, showing a full list of pending identifier suggestions for the active competitor with per-suggestion Add/Dismiss buttons and an Add all button. It allows you to page across competitors.

​
Data shown

  • Tracked competitors: The competitors you actively track, alongside their configured identifiers and domains for the currently selected website.
  • Discovered competitor candidates: Brands AI has discovered based on mention frequency in analyzed AI responses.
  • Soft-deleted competitors: Competitors you’ve removed for the current website, available for restoration.
  • Identifier suggestions: Pending keywords detected from AI responses that could help track your brand or competitors better.
  • Audit log history: A record of changes for each competitor.
  • Logos: Competitor and website logos fetched from a dedicated logo storage service.
  • Draft change queue: Pending identifier, competitor, or domain changes awaiting backfill to reanalyze historical data.
  • Response dates: Dates with data (used for the date picker dot indicators in the Change Queue Bar).

​
Common workflows

1. Add a single competitor
  1. Click the “Add Competitor” button.
  2. Enter the competitor’s website URL in the autocomplete field (this auto-fills the name from the company search).
  3. Enter or confirm the competitor name.
  4. Click “Add” to save; identifiers are AI-generated automatically.
  5. The competitor appears in the Tracked competitors table.
2. Bulk import competitors by name
  1. Click the “Add Competitor” button.
  2. Switch to the “Multiple” tab.
  3. Select “By name” mode.
  4. Enter competitor names separated by commas or newlines.
  5. Click “Preview” to look up companies and generate identifiers.
  6. Review the preview list, edit names/URLs/identifiers if needed, and remove unwanted entries.
  7. Click “Add N competitors” to confirm.
3. Edit competitor identifiers
  1. Locate the competitor row in the Tracked competitors table.
  2. Click the identifiers pill (e.g. “3 identifiers”) to open the dropdown.
  3. Add a new identifier by typing in the input and clicking Add, or remove an existing one by hovering and clicking the X.
  4. Optionally toggle “Match case-sensitively”.
  5. Changes are saved immediately and queued for backfill in the Change Queue Bar.
4. Backfill past responses after changes
  1. Make one or more identifier, domain, or competitor changes (they appear in the Change Queue Bar at the bottom).
  2. Optionally click “View Changes” to review and undo individual changes.
  3. Select a date range in the Change Queue Bar to limit which past responses are reanalyzed.
  4. Click “Backfill” (which shows a credit cost badge); confirm you have sufficient credits.
  5. A background job reanalyzes past AI responses; a success toast confirms the backfill started.
5. Add a discovered competitor
  1. Click the “Discovered competitors” tab.
  2. Review the table of AI-discovered candidates sorted by mention rate.
  3. Optionally expand a row to see evidence snippets from actual AI responses.
  4. Click “Add” next to a candidate to track it as a competitor.
  5. The competitor moves to the Tracked competitors tab.

​
Empty, loading, and error states

  • Empty:
    • Tracked tab: The table shows “No results.” when no competitors exist.
    • Discovered tab: Shows “No discovered competitors yet”.
    • Deleted tab: Shows “No deleted competitors”.
    • No website selected: Shows “Please select a website to view its competitors”.
  • Loading: The table shows a centered animated loader spinner while competitors are loading.
  • Error: Individual actions (like saving an edit) show toast error messages. The page itself does not show a dedicated error state.

​
Common support questions

Can I bulk import competitors? Yes, click Add Competitor and switch to the Multiple tab to enter a list of names, URLs, or upload a CSV. Why is my Backfill button disabled? You may need an active subscription plan, or you might not have sufficient credits to cover the responses in the selected date range. How do I delete multiple competitors at once? Select the checkboxes next to the competitors you want to remove, and use the command bar that appears at the bottom of the screen to click Delete. Can I delete my own website? No, your own website row (labeled with “You”) appears at the top of the table and cannot be deleted from the competitors list. Why is the Export CSV option opening an upgrade prompt? The Export functionality requires a paid subscription plan. If you are on a free plan, clicking Export will prompt you to view our plans.