# Competitors

Competitors tell GrackerAI which other brands to watch for in AI responses. When a competitor is tracked, GrackerAI records every time they're mentioned. in which prompts, on which surfaces, and in what position relative to your brand.

---

## Where to Find It

Go to **Configuration → Brand Settings → Competitors tab**.

![Competitors List](/docs/images/brand_setting_competitor.png)

---

## What Competitor Tracking Gives You

- **Share of voice**. how often each competitor appears vs your brand across your prompt library
- **Head-to-head comparisons**. side-by-side visibility on the same prompts
- **Discovered entities**. unknown brands that appear in AI responses can be promoted to tracked competitors
- **Competitor citation sources**. which URLs AI surfaces are pulling to support competitor mentions

---

## Adding a Competitor

1. Go to **Configuration → Brand Settings → Competitors tab**
2. Click **Add**
3. Enter the name, domain, and any aliases
4. Click **Save**

**Fields:**
- **Name:** The competitor's brand name, used for mention detection
- **Domain:** Their primary domain, e.g. `competitor.com` (no `https://` or trailing paths)
- **Aliases:** Alternative names AI surfaces might use for this competitor
- **Additional Domains:** Other domains they own that AI might cite

---

## Fill with Gracker Agent

Click **Fill with Gracker Agent** and GrackerAI analyses your brand context to suggest competitor candidates - review, edit, and keep the ones that are real rivals. The fastest way to seed a competitor list on a new brand.

---

## Bulk Import

1. Click **Bulk Import**
2. Paste one competitor per line - columns separated by tabs (or 2+ spaces), in this order: `name`, `domain`, then optional `aliases` and `additional domains` (comma- or pipe-separated)
3. In a multi-product workspace the second column is the required `company` (parent company), so the order becomes `name`, `company`, `domain`, ...
4. GrackerAI validates each row and flags duplicates before importing

---

## Editing and Archiving

**To edit:** Click the edit icon on any competitor row, update fields, and save.

**To archive:** Click the archive icon on the row and confirm. Archiving preserves all historical data. the competitor no longer appears in active analytics but can be restored at any time.

**To restore:** Switch the list filter to **Archived**, find the competitor, and click **Restore**.

---

## How Many Should You Track?

Start with your top 3–5 direct competitors. Add more as you discover unfamiliar brands appearing in your AI responses via [Discovered Entities](/docs/advanced/discovered-entities). You can promote any entity directly to a tracked competitor from there, no manual entry needed.

---

## Next Steps

- [View analytics](/docs/getting-started/analytics): see competitor visibility alongside yours
- [Check discovered entities](/docs/advanced/discovered-entities): find brands appearing in responses you haven't tracked yet

- [Set up monitor groups](/docs/using-gracker/working-with-monitors/monitors): add competitor comparison prompts to your tracking
- [Competitor as Product](/docs/setup/competitor-as-product): set competitors up correctly in a multi-product workspace
