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