> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Frequently Asked Questions

> Find answers to common questions about using Qwairy — scores, credits, monitoring, competitors, exports, and more.

## Understanding Scores & Metrics

<Accordion title="How is the GEO Score calculated?">
  The GEO Score is a composite score from 0 to 100 built from 4 weighted sub-scores:

  | Sub-score                      | Weight | What it measures                                       |
  | ------------------------------ | ------ | ------------------------------------------------------ |
  | **Brand Mention Visibility**   | 35%    | Percentage of AI responses that mention your brand     |
  | **Share of Voice**             | 25%    | Your share of all brand mentions (yours + competitors) |
  | **Source Citation Visibility** | 20%    | Percentage of responses citing your domain as a source |
  | **Sentiment**                  | 20%    | Tone of how AI describes your brand (0–100)            |

  On top of the base score, Qwairy adds **bonus points** (up to 23) for:

  * **Progression** — score is improving over time (up to 10 pts)
  * **Quality** — high sentiment (up to 5 pts)
  * **Multi-provider presence** — visible across multiple AI models (up to 5 pts)
  * **Top position** — frequently ranked first in lists (up to 3 pts)

  The final score is capped at 100.
</Accordion>

<Accordion title="What is the difference between a mention and a citation?">
  * **Mention** — your brand name appears in the AI-generated text (e.g., "Qwairy is a GEO platform"). The AI talks about you, but may not link to your site.
  * **Citation** (or source citation) — the AI references a specific URL from your domain as a source. This means the model not only knows you exist, but trusts your content enough to cite it.

  A high mention rate with a low citation rate means AI talks about your brand but relies on third-party sources to back it up. The goal is to improve both.

  You can see the breakdown in **Cockpit > Overview** (Brand Mention Visibility vs. Source Citation Visibility).
</Accordion>

<Accordion title="What does Share of Voice mean in Qwairy?">
  Out of all brand mentions in AI responses, Share of Voice (SoV) is the percentage that is yours. The denominator is every brand mention detected — yours plus all competitors.

  Formula: `Your brand mentions ÷ All brand mentions (yours + competitors) × 100`

  For example, if your brand and competitors together generate 100 mentions and 25 of them are yours, your SoV is 25%.

  Track it in **Cockpit > Overview** and compare it against competitors in **Cockpit > Compare**.
</Accordion>

<Accordion title="Why is my score different across AI providers?">
  Each AI provider (ChatGPT, Claude, Gemini, Perplexity, etc.) uses different training data, retrieval methods, and ranking algorithms. This means:

  * A provider with web search (Perplexity, AI Overview) may cite your recent content
  * A provider relying on training data (ChatGPT, Claude) may reflect older information
  * Some providers weight certain source types (Reddit, Wikipedia, review sites) more than others

  Use the **Cockpit > GEO Matrix** to see your score per provider, and the **Cockpit > Compare** breakdown to benchmark against competitors on each provider.
</Accordion>

<Accordion title="What is the GEO Matrix?">
  The GEO Matrix is a heatmap that maps your brand's AI visibility across two dimensions: **rows** (topics, tags, funnel stages, or individual prompts) and **columns** (AI providers).

  Each cell displays a score from 0 to 100, color-coded from red (invisible) to green (excellent). This lets you instantly spot which topic × provider combinations need work.

  Click any cell to see the detailed score breakdown, top competitors, and cited sources.

  Navigate to **Cockpit > GEO Matrix** to access it.
</Accordion>

***

## Credits & Pricing

<Accordion title="How are credits calculated for a monitoring run?">
  The formula is:

  ```
  Total credits = Number of prompts × Sum of credits per selected model
  ```

  **Core models** cost **1 credit** each: ChatGPT, Gemini, Perplexity, Google AI Overview, Google AI Mode, Microsoft Copilot, Grok.

  **Premium models** cost between **2 and 6 credits** each:

  | Credits | Models                                                                                       |
  | ------- | -------------------------------------------------------------------------------------------- |
  | 2       | Claude Haiku 4.5, GPT-5 nano, GPT-5 mini, Perplexity Sonar, DeepSeek Chat, DeepSeek Reasoner |
  | 3       | Claude Sonnet 4/4.5/4.6, GPT-5, GPT-5.1, Perplexity Sonar Pro, Grok 3 Mini, Mistral Small    |
  | 4       | Gemini 2.5 Flash, Gemini 3 Flash, Mistral Medium, Mistral Large                              |
  | 5       | Claude Opus 4.5/4.6, Gemini 2.5 Pro, Gemini 3 Pro, Grok 3, Grok 4                            |
  | 6       | Perplexity Sonar Deep Research                                                               |

  **Example:** 30 prompts with ChatGPT (1) + Claude Sonnet 4 (3) + Perplexity (1) = 30 × 5 = **150 credits**.

  The exact cost is displayed before you confirm any analysis run.
</Accordion>

<Accordion title="How do I buy more credits?">
  1. Go to **Team Management > Billing** or visit: [https://www.qwairy.co/dashboard/team/billing](https://www.qwairy.co/dashboard/team/billing)
  2. Click **Upgrade Plan** or **Buy Credits**
  3. Select your desired plan or credit package
  4. Complete the payment through Stripe

  Credits are shared across all team members and all brands in your workspace.
</Accordion>

<Accordion title="What are the available plans?">
  | Plan           | Price                     | Credits/month | Workspaces | Prompts   |
  | -------------- | ------------------------- | ------------- | ---------- | --------- |
  | **Starter**    | €79/month or €790/year    | 1,300         | 1          | Up to 100 |
  | **Growth**     | €199/month or €1,990/year | 3,900         | 5          | Up to 300 |
  | **Business**   | €449/month or €4,490/year | 10,400        | 20         | Up to 800 |
  | **Enterprise** | Custom                    | 50,000        | Unlimited  | Unlimited |

  A workspace is a monitored brand. All plans include unlimited team members. See the full comparison at [qwairy.co/pricing](https://www.qwairy.co/pricing).

  Your plan's workspace count is a single shared quota for the whole organization. On Business and Enterprise plans, Virtual Teams lets you split that quota across sub-teams: each sub-team draws its workspaces and credits from the same organization pool rather than getting a separate allowance. Moving a workspace between your organization and a sub-team carries its reserved slot with it, so your total workspace allowance never changes.

  Two workspace types behave differently here. Pitch workspaces (Agency plans) are prospecting brands kept separate from production monitoring and do not count toward your brand limit. Sub-team workspaces (Virtual Teams) are regular production brands that live inside a sub-team and still count against your organization's shared quota.
</Accordion>

***

## Monitoring & Data

<Accordion title="How do I change my monitoring frequency?">
  1. Go to **Workspace > Monitoring**
  2. Find the **Automatic Schedule** section
  3. Select your preferred frequency:
     * **None** — manual runs only
     * **Daily** — every day
     * **Weekly** — pick a day of the week
     * **Monthly** — pick a day of the month
  4. Click **Save Schedule**

  <Info>
    Higher frequency consumes more credits. Weekly is recommended for most brands.
  </Info>
</Accordion>

<Accordion title="Can I run an analysis on a subset of prompts?">
  Yes. In **Workspace > Monitoring**, you can filter by:

  * **Topic** — only run prompts from a specific topic
  * **Tag** — only run prompts with a specific tag
  * **Model** — choose which AI models to include

  The credit cost updates in real time as you adjust the filters.
</Accordion>

<Accordion title="How quickly is data available after a monitoring run?">
  Most results appear within a few minutes after launching an analysis. For large prompt sets (40+ prompts) or premium models, it may take up to 10–15 minutes.

  Look for the **"Generating"** indicator next to your brand name — it disappears once all responses are processed.
</Accordion>

<Accordion title="Why are my responses not generating?">
  If your responses are stuck or not generating, check the following:

  * **Insufficient credits** — check your credit balance in **Team Management > Billing**
  * **Generation in progress** — look for the "Generating" indicator next to your brand
  * **Provider issues** — some AI providers may be temporarily unavailable
  * **Rate limits** — wait a few minutes if you've triggered many generations

  If the issue persists, contact us via the chat on Qwairy.
</Accordion>

***

## Competitors

<Accordion title="How are competitors detected?">
  Competitors are **automatically extracted** from AI-generated responses. When an AI model mentions other brands alongside yours in a response, Qwairy identifies them and adds them to your competitor list.

  You don't need to configure anything — Qwairy discovers competitors as it analyzes responses. New competitors can appear after each monitoring run.

  Manage your competitor list in **Monitor > Competitor Mentions**, where you can mark competitors as favorites, set their relationship (direct, indirect), or hide irrelevant ones.
</Accordion>

<Accordion title="How do I compare my brand against competitors?">
  Go to **Cockpit > Compare** and select up to 10 competitors from the dropdown. The tab shows:

  * **Metrics Table** — side-by-side comparison of 10 KPIs
  * **Positioning Map** — scatter plot on any 2 metrics
  * **Overlap Matrix** — heatmap of how often brands co-appear
  * **Evolution Chart** — trends over time per competitor
  * **Breakdown** — comparison by provider, topic, tag, or funnel stage

  See the [Compare documentation](/documentation/overview/compare) for details.
</Accordion>

***

## Workspace & Brand Management

<Accordion title="How do I add a new brand?">
  1. Click the **brand switcher** in the top navigation
  2. Select **Add Brand**
  3. Enter your website URL
  4. Follow the 5-step onboarding wizard:
     * Review auto-detected brand info
     * Review topics
     * Select prompts to monitor
     * Configure monitoring frequency and AI models
     * Launch your brand

  <Warning>
    The number of brands (workspaces) you can add depends on your plan (Starter: 1, Growth: 5, Business: 20, Enterprise: unlimited).
  </Warning>
</Accordion>

<Accordion title="How do I archive a brand?">
  1. Go to **Workspace > Settings** for the brand you want to archive
  2. Scroll to the **Danger Zone** section
  3. Click **Archive Brand**
  4. Type the brand name to confirm

  <Info>
    Archiving is a reversible status change. The brand stops consuming credits and is hidden from the active brand list, but its prompts, responses, analytics, and settings are preserved. You can restore an archived brand at any time.
  </Info>
</Accordion>

<Accordion title="How can I delete a prompt?">
  1. Navigate to **Workspace > Prompts**
  2. Find the prompt you want to delete in the list
  3. Click the **three-dot menu (...)** next to the prompt

       <img src="https://mintcdn.com/qwairy/4Z9ttgZtiIq38oup/images/faq-1.png?fit=max&auto=format&n=4Z9ttgZtiIq38oup&q=85&s=f62d29e46ffef29161ea0208fb7a7673" alt="Delete prompt menu" width="2932" height="1440" data-path="images/faq-1.png" />
  4. Select **"Delete Prompt"** from the dropdown
  5. Confirm your action

  You can also select multiple prompts using checkboxes and use **Bulk Delete**.

  <Warning>
    Deleting a prompt removes all associated responses and analytics. This action is permanent.
  </Warning>
</Accordion>

<Accordion title="How can I delete a topic?">
  1. Go to **Workspace > Topics**
  2. Find the topic you want to remove

       <img src="https://mintcdn.com/qwairy/4Z9ttgZtiIq38oup/images/faq-2.png?fit=max&auto=format&n=4Z9ttgZtiIq38oup&q=85&s=d929d3c2b3fcf703c448deb76e42a380" alt="Topic list with delete option" width="2866" height="1406" data-path="images/faq-2.png" />
  3. Click the **trash bin icon** in the Actions column
  4. Confirm the deletion

  <Warning>
    Deleting a topic removes it from all associated prompts and from GEO Matrix / Compare breakdowns. Prompts themselves are not deleted.
  </Warning>
</Accordion>

***

## Exports & Integrations

<Accordion title="How do I export my data?">
  You can export data in two ways:

  **1. From Workspace > Exports**

  Trigger an export from the dashboard, then download it as **CSV** from the Exports page. Available export types include: responses, competitors, sources, prompts, sentiment, shopping, social, and more.

  **2. Via Looker Studio**

  Connect Qwairy to Google Looker Studio for automated, refreshable reports. See the [Looker Studio documentation](/looker-studio/getting-started).

  **3. Via the API**

  Use the REST API to pull data programmatically. See the [API Reference](/api-reference/introduction).
</Accordion>

<Accordion title="How do I connect Google Search Console?">
  1. Go to **Measure > Google Search Console**
  2. Click **Connect Google Search Console**
  3. Sign in with your Google account
  4. Select the property you want to connect
  5. Grant Qwairy read-only access to your data

  Once connected, Qwairy syncs your keyword data and cross-references it with AI visibility. You can see which queries rank on Google but are invisible in AI responses.
</Accordion>

<Accordion title="How do I use the Qwairy API?">
  1. Go to **Team Management > API** ("API Access") at [https://www.qwairy.co/dashboard/team/api](https://www.qwairy.co/dashboard/team/api)
  2. Click **Create API Key** and give it a descriptive name
  3. Copy the key immediately (it's shown only once)
  4. Use it in the `Authorization` header:

  ```bash theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    https://www.qwairy.co/api/v1/brands
  ```

  The REST API is available on Growth plans and above. See the [API Reference](/api-reference/introduction) for all available endpoints.
</Accordion>

<Accordion title="What is the MCP integration?">
  The Model Context Protocol (MCP) lets AI assistants like Claude access your Qwairy data in real time. You can ask questions like "How is my brand performing on Perplexity?" and get live answers from your monitoring data.

  See the [MCP documentation](/mcp/introduction) to set it up.
</Accordion>

***

## Team & Billing

<Accordion title="How do I invite a new member?">
  1. Go to **Team Management > Members** or visit: [https://www.qwairy.co/dashboard/team/members](https://www.qwairy.co/dashboard/team/members)
  2. Click **Invite Member**
  3. Enter the email address and select a role

  **Access levels:**

  | Role        | Permissions                                                                    |
  | ----------- | ------------------------------------------------------------------------------ |
  | **Owner**   | Full access including ownership transfer, cannot be removed                    |
  | **Manager** | Full access including billing, adding brands, team settings, viewer management |
  | **Member**  | Full access except billing management                                          |
  | **Viewer**  | Read-only access to assigned brands only                                       |
</Accordion>

<Accordion title="How do I find my invoice?">
  All invoices are available in **Team Management > Billing** or at: [https://www.qwairy.co/dashboard/team/billing](https://www.qwairy.co/dashboard/team/billing)

  Click on any past invoice to download or view the PDF.
</Accordion>

***

## Troubleshooting

<Accordion title="Why is nothing showing on my dashboard?">
  This can happen for several reasons:

  <img src="https://mintcdn.com/qwairy/4Z9ttgZtiIq38oup/images/faq-3.png?fit=max&auto=format&n=4Z9ttgZtiIq38oup&q=85&s=000bdb69f6e49e609cc2493150ef9851" alt="Empty performance dashboard" width="2228" height="1216" data-path="images/faq-3.png" />

  **1. Generation is still in progress**

  After onboarding, Qwairy needs a few minutes to generate responses. Look for the "Generating" indicator next to your brand name.

  <img src="https://mintcdn.com/qwairy/4Z9ttgZtiIq38oup/images/faq-4.png?fit=max&auto=format&n=4Z9ttgZtiIq38oup&q=85&s=a9b57348b83fef7fb7ec6197bd30d049" alt="Generating indicator" width="2926" height="1380" data-path="images/faq-4.png" />

  **2. Topics don't match your brand**

  If the auto-generated topics don't align with your actual business, AI responses won't mention your brand. Go to **Workspace > Topics** to review and adjust them.

  **3. Your brand is genuinely absent from AI responses**

  This is the most common case — AI models don't mention your brand for the monitored prompts. This is actually the starting point for a GEO strategy: use Content Opportunities and Content Studio to create content that gets your brand into AI responses.

  If you believe there's a bug, contact us via the chat on Qwairy.
</Accordion>

<Accordion title="Why does a provider show 0% visibility?">
  A provider showing 0% visibility means that none of the AI responses from that provider mention your brand for your monitored prompts. Common reasons:

  * **Provider relies on different sources** — ChatGPT and Claude use training data, while Perplexity uses live web search. Your brand may be visible on one but not the other.
  * **Topic mismatch** — the provider may not cover your niche well.
  * **Content gap** — the sources the provider trusts don't mention your brand.

  Check the **Cockpit > GEO Matrix** to see which provider × topic combinations are 0, then use **Monitor > Citation Sources** to understand which sources the provider relies on.
</Accordion>

<Accordion title="Does Qwairy access or crawl my website?">
  No. Qwairy does not crawl or scrape your website. It analyzes what AI models (ChatGPT, Perplexity, Claude, Gemini, etc.) say about your brand by sending monitored prompts and analyzing the responses.

  The only connection to your site is through **Google Search Console** and **Bing Webmaster Tools** integrations — and these require your explicit authorization with read-only access.
</Accordion>

<Accordion title="Why do I see pages from another domain in this workspace?">
  By default, a workspace counts pages and citations across its whole registrable domain — so a workspace on a subdomain (e.g. `blog.example.com`) also surfaces pages from the parent domain (`example.com`) and sibling subdomains.

  To restrict it to the exact subdomain, enable **Limit pages to this subdomain** in **Workspace > Settings > Configuration**. See [Configuration](/documentation/workspace/configuration) for details.
</Accordion>