> For the complete documentation index, see [llms.txt](https://docs.sageseo.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sageseo.ai/getting-started/domains.md).

# Domains Overview

The Domains Overview is the **portfolio view** for your agency. Every client domain you manage sits on this one page, each row showing live search performance pulled directly from Google Search Console. It's the page you open first thing in the morning to see which clients need attention and the page you close last to confirm nothing's on fire.

{% hint style="info" %}
**Key Takeaways**

* One row per client domain, with live impressions / clicks / CTR from GSC
* Auto-generated **Company Overview** per domain feeds the AI Suggestions Engine downstream
* Adding a new domain takes \~60 seconds + GSC OAuth approval
* The domain MUST already exist in your Google Search Console account
* Click any row to drill into that domain's full dashboard, content calendar, and SEO analytics
  {% endhint %}

## What you see on the page

```mermaid
flowchart LR
  A[Connected client domains] --> B[Live GSC metrics<br/>impressions / clicks / CTR]
  A --> C[AI-generated company overview<br/>powers downstream suggestions]
  A --> D[Per-domain refresh + edit + remove]
  B --> E[Spot underperformers at a glance]
  C --> E
  D --> E
  E --> F[Decide where to focus content investment this week]
  classDef phase fill:#F0F6FF,stroke:#0052CC,color:#091E42
  class A,B,C,D,E,F phase
```

### The domain list

Each row represents one client domain. The columns at a glance:

| Column                | What it shows                                                                    |
| --------------------- | -------------------------------------------------------------------------------- |
| **Domain name**       | The client's site URL + a friendly label you can edit                            |
| **Impressions (30d)** | How often the site appeared in search results last 30 days                       |
| **Clicks (30d)**      | How often someone actually clicked through                                       |
| **CTR**               | Clicks ÷ Impressions — a quick signal of whether titles/descriptions are working |
| **Status pill**       | Connected (live GSC sync) · Disconnected (needs re-auth) · Stale (data >24h old) |
| **Actions**           | Refresh now · Open dashboard · Edit · Remove                                     |

### The Company Overview

When you add a new domain, Sage automatically:

1. Crawls the **homepage + service pages**
2. Generates a 1-paragraph company overview describing what the business does
3. Assigns 2 **industry categories** based on the content

This overview is what makes the AI Suggestions Engine actually useful — Sage knows the client is "a B2B accounting software company serving SMBs" instead of just "they have a website." Suggestions get framed accordingly.

You can edit the overview anytime to refine the framing. The next batch of AI suggestions will use the updated version.

## Adding a new domain

```mermaid
sequenceDiagram
    participant You
    participant Sage
    participant GSC as Google Search Console
    You->>Sage: Click Add Project
    Sage->>GSC: Open OAuth flow
    GSC->>You: Choose Google account
    You->>GSC: Approve Sage's access
    GSC->>Sage: Return with property list
    You->>Sage: Pick the domain to track
    Sage->>Sage: Crawl homepage, generate Company Overview
    Sage->>Sage: Pull last 30 days of GSC data
    Note over Sage,GSC: Domain now live in your portfolio
```

The full flow:

1. **Click "Add Project"** at the top of the Domains Overview
2. **Connect Google Search Console** — pick the Google account that owns the domain's GSC property
3. **Choose the domain** — Sage lists every property in your GSC; pick the one to track
4. **Confirm client details** — optionally edit the auto-detected company name + primary contact
5. **Done** — the domain appears in your portfolio within 30–60 seconds

{% hint style="warning" %}
**The domain must already exist in your Google Search Console account.** Sage doesn't add domains to GSC for you — that's GSC's separate verification process. If a client doesn't have GSC set up yet, that's step 0 before Sage can do anything.
{% endhint %}

## Why this is your starting point

Sage is built around **per-domain** workflows — almost every other page in the platform is scoped to one domain at a time. The Domains Overview is the one place you see across all clients at once.

Daily usage pattern:

1. **Morning glance** — Domains Overview to see which clients have new activity or stalled metrics
2. **Click into a domain** — Open Content Calendar or Performance Dashboard for that client
3. **Take action** — Queue new article topics, review pending publishes, check indexing status
4. **Return to portfolio view** — Move to the next client

The clients you want at the top of the list are usually the ones with **rising CTR** or **rising impressions but flat clicks** — both signal opportunity. The CTR shows titles+descriptions are working; the flat-clicks-with-rising-impressions tells you content is matching new queries but not converting them yet.

## What Sage handles automatically per domain

* **Daily GSC refresh** — Sage re-pulls impressions/clicks/CTR every 24 hours
* **Per-URL indexing inspection** — see the Google Index dashboard for each domain's coverage
* **Sitemap sync** — Sage knows every published URL on each domain via its `sitemap.xml`
* **Company overview refresh** — re-crawls the homepage periodically to catch business changes

## Pro tips

| Situation                                    | Fix                                                                               |
| -------------------------------------------- | --------------------------------------------------------------------------------- |
| Metrics look outdated                        | Click **🔄 Refresh** beside the domain — pulls fresh GSC data on demand           |
| Domain missing from the GSC list when adding | Make sure you're logged into the Google account that owns the GSC property        |
| Need to reclassify the company overview      | Click **Edit** on the domain → update the summary or industry categories manually |
| Large portfolio                              | Use the search bar (top right) to filter domains by name                          |
| Stale "Disconnected" status                  | Click **Reconnect GSC** — the OAuth token expired, refresh takes 30 seconds       |

## Frequently asked questions

### How often does Sage auto-refresh data?

Every 24 hours by default. You can force a refresh on any domain anytime via the Refresh button — that pulls fresh data within \~30 seconds.

### Will deleting a domain remove historical data?

Yes. Removal is permanent — articles, generation history, GSC snapshots, and the company overview are all dropped. Only do this if the client is truly no longer being served.

### Can I connect the same GSC account to multiple Sage workspaces?

Yes. Each workspace stores its own GSC credentials securely. Useful if you run multiple agency entities or want to separate prod from staging.

### Does Sage need access to all of my GSC properties?

Sage only reads the properties you explicitly add as domains. GSC's OAuth flow grants Sage permission to *see* your property list, but you choose which ones to actually track in Sage.

### What's the difference between this page and the Performance Dashboard?

* **Domains Overview** = portfolio view across all clients (this page)
* **Performance Dashboard** = drill-in for one specific client's keyword/page/traffic detail

Use this page to navigate; use the Dashboard to investigate.

## Related

* [AI Content Suggestions Engine](/getting-started/content-calendar.md) — next step after adding a domain
* [Domain Performance Dashboard](/getting-started/dashboard.md) — drill into one client's full SEO data
* [SEO Analytics](/getting-started/seo-analytics.md) — deeper query + page-level breakdowns
* [Search Integrations](/getting-started/integrations.md) — full GSC + GA connection mechanics