# Connect Google Search Console

> Connect a Search Console property so Rivelant can find quick wins and measure what it publishes. Read-only access.

Search Console is where Rivelant gets your real clicks and positions on Google. It uses them to find the searches you almost win, and to measure every article at day 7, 14 and 28. **Every campaign needs it**: until it's connected, **New campaign** asks you to **Connect Search Console first**.

Rivelant's access is **read-only**: it never changes anything in your Search Console.

## Connect

1. Open your project's **Settings** › **Integrations**, and click **Connect** on the **Google Search Console** card. (You can also start from **Settings** › **General** › **Data sources**, the **Connect** row on the Workbench, **Connect Search Console** in **New campaign**, or during onboarding.)
2. Google opens. Choose the Google account that has access to your site's property and allow access.
3. Back in Rivelant, click **Choose property**, pick your site's property and click **Save property**.

You'll see **Search Console connected**, and the card shows **Connected** with the property and Google account.

Owners and admins of your organization can connect Search Console. Other members see a note asking an owner or admin to do it.

## Which property to choose

Rivelant accepts both kinds of Search Console property:

- **Domain property** (`sc-domain:example.com`): covers every subdomain and protocol. Choose this one if you have it.
- **URL-prefix property** (`https://www.example.com/`): covers only addresses under that prefix.

Properties you can see but aren't verified for are marked **No verified access** and can't be chosen. Ask the property's owner in Search Console to add you as a verified user, or verify the site yourself.

If your project tracks several markets (for example `/fr/` and `/de/`) and a URL-prefix property doesn't include them all, Rivelant tells you. Connect a property that covers them, or switch to a domain property.

## After you connect

Rivelant loads up to 16 months of history and then syncs every day. Search Console's own data runs about 3 days behind, so the latest days fill in later.

## Change or disconnect

- **Change property or account** lets you pick another property, or add another Google account.
- **Disconnect project** removes the property from this project immediately. Your Google account stays available for other projects.
- To remove a Google account entirely, open the property picker and choose **Remove account**. Rivelant tells you which projects it disconnects.

## If it doesn't work

| You see                                 | What to do                                                                                                                                          |
| --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| Search Console connection was canceled  | Google's permission screen was closed or declined. Click **Connect** again.                                                                         |
| Search Console connection didn't finish | The attempt expired or was interrupted. Try again in a single browser tab, finish Google's steps within 10 minutes, and allow cookies for Rivelant. |
| No properties available                 | The Google account you chose has no Search Console properties. Click **Add Google account** and choose the right one.                               |
| Connection expired                      | Click **Reconnect** and allow access again.                                                                                                         |
