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

# Connections

> One safe place for every outside service your site uses: email, spam protection, Google, Instagram, ads, analytics and FetchskiAI.

**Connections** is where you link your site to the outside services it uses, such as your email provider, Google and Instagram. Each service has its own card, with a badge that tells you at a glance whether it's set up. Private keys and passwords you save here are sealed: nobody can read them back, not even you. A few keys are public by design, because visitors' browsers need them; [Saved keys and passwords](#saved-keys-and-passwords) explains the difference.

 **Who can do this:** Admins and Owners. Editors, Contributors and Viewers don't see Connections.

![The Connections window on its Overview: the intro line, the "Sealed vault" note, and the Essentials and Google sections with their cards and badges (Email Not set up, Spam protection Off, Google Business Profile and Google Reviews Not set up, Google Maps and Google Sheets Connected), with every connection listed down the left.](https://mintcdn.com/fetchski-attract-api/MsE85fjBwOCKqNGh/images/cms/guides/connections/index/guides-connections-index-screen-light.png?fit=max\&auto=format\&n=MsE85fjBwOCKqNGh\&q=85\&s=47be3297b02b758b1ddbcfc978594e5f)

Connections: one card per outside service, each with its own badge.

## Open Connections

* In the toolbar (the bar across the top of your site once you're signed in; see [The toolbar](https://docs.fetchski-attract.com/guides/get-started/toolbar-and-command-palette.md#the-toolbar)), choose **Connections**.
* Or open the command palette (⌘K, or Ctrl+K on Windows) and choose **Connections**. The shortcut is T then E (press T, let go, then press E, while you're not typing in a box; see [Keyboard shortcuts](https://docs.fetchski-attract.com/guides/get-started/toolbar-and-command-palette.md#keyboard-shortcuts)).

The window opens on **Overview**, with every card grouped by kind: **Essentials**, **Google**, **Social and photos**, **Ads and conversions**, **Analytics** and **Fetchski services**. The same list runs down the left side, with a colored dot for each card's status.

## Every card in Connections

> [card] [Email notifications](https://docs.fetchski-attract.com/guides/forms/email-notifications.md)
>
> the **Email** card. Send form notifications and every other email from your site.

> [card] [Spam protection](https://docs.fetchski-attract.com/guides/forms/spam-protection.md)
>
> the **Spam protection** card. Check form submissions for bots with Google reCAPTCHA.

> [card] [Google Business Profile](https://docs.fetchski-attract.com/guides/connections/google-business-profile.md)
>
> connect your Google listing, then manage it in the Google Business Dashboard.

> [card] [Google Reviews](https://docs.fetchski-attract.com/guides/connections/google-reviews.md)
>
> bring your Google reviews onto your site on a schedule.

> [card] [Google Maps](https://docs.fetchski-attract.com/guides/connections/google-maps.md)
>
> the key that draws your service area map.

> [card] [Google Sheets](https://docs.fetchski-attract.com/guides/connections/google-sheets.md)
>
> copy form submissions into a Google Sheet.

> [card] [Instagram](https://docs.fetchski-attract.com/guides/connections/instagram.md)
>
> show your latest Instagram posts on your site.

> [card] [Photo storage](https://docs.fetchski-attract.com/guides/connections/photo-storage.md)
>
> link the cloud storage your photo feeds read from.

> [card] [Conversion tracking](https://docs.fetchski-attract.com/guides/connections/conversion-tracking.md)
>
> the **Google Ads**, **Google Analytics 4**, **Meta** and **TikTok** cards.

> [card] [Analytics](https://docs.fetchski-attract.com/guides/connections/analytics.md)
>
> the **Plausible Analytics** card, for the Analytics Dashboard.

The **Fetchski services** cards are covered below.

## How a card works

Choose a card to open it. At the top you see the service's name, what it does for your site and its badge. Below that are its settings, often with a **Setup guide** that walks you through the steps on the service's own website. To go back, choose **All connections**.

![The Google Sheets card open: the All connections link, the card header with its Connected badge and "Share each sheet with the service account to use it.".](https://mintcdn.com/fetchski-attract-api/MsE85fjBwOCKqNGh/images/cms/guides/connections/index/guides-connections-index-card-light.png?fit=max\&auto=format\&n=MsE85fjBwOCKqNGh\&q=85\&s=9e18a511a5c1872e7ecd7ed61259c73f)

An open card: what it does, its status, a setup guide and its settings.

### The badges

Each badge describes what's **saved**, not what you're typing. It changes after you choose **Save**.

| Badge | What it means |
| - | - |
| **Not set up** | Nothing is saved for this service yet. |
| **Off** or **Not linked** | The service's switch is off, or (Fetchski Engage) no address is saved. |
| **Finish setting up** | Something is missing. Open the card: a line under the header says what to add. |
| **Connected**, **On**, **Linked** or **Set** | Everything it needs is saved. That doesn't prove the service accepted it. Many cards add a detail line, such as the last sync time: the best sign it works. Instagram shows the account, such as **Connected as @yourbusiness**. |
| **Not sending yet** | An ad platform card is set up, but its last conversion wasn't sent. The line under the header says why. |
| **Needs attention** | An ad platform reported a failed send. The line under the header shows it. |
| **Optional** | You can leave it empty. |
| **Managed by Fetchski** | Fetchski runs this for your site. |

To be sure a connection works, check the result on the service itself, or on your site: the guide for each card says how.

While you have unsaved changes on a card, it shows **Unsaved changes**. If a card has a mistake that stops you saving, its badge reads **Fix errors**.

### Advanced options

Settings most sites never change fold away under **Advanced options**, at the bottom of a card. Choose it to open them. Some advanced settings only appear once a switch above them is on.

### Saved keys and passwords

Keys, tokens and passwords are sealed when you save. After that, the field shows dots and **Saved and encrypted**. Nobody can read the value again, so keep your own copy somewhere safe if you need it.

* **Replace**: type or paste a new value. The box shows "Enter a new value to replace the saved one". Changed your mind? Choose **Cancel**.
* **Remove**: clears the value when you save. The field says "The saved value will be removed when you save." Choose **Undo** to keep it.
* **An empty field** shows "Paste the value", with the note "Encrypted when you save. It can't be viewed again afterwards."
* **A value the CMS fills in for you**, such as a token from signing in with Google, shows **Saved and encrypted (set automatically)**, or "Not set yet." before then.

![Three captures of the same saved key, stacked: saved (dots, Saved and encrypted, Replace, Remove); Replace chosen (an empty box reading "Enter a new value to replace the saved one", with Cancel); and Remove chosen ("The saved value will be removed when you save", with Undo).](https://mintcdn.com/fetchski-attract-api/tIdeo2aKESm5opj4/images/cms/guides/connections/index/guides-connections-index-secret-states-light.png?fit=max\&auto=format\&n=tIdeo2aKESm5opj4\&q=85\&s=2de76e11efa96bcb60c1bd60ed74022e)

A saved key: replace it or remove it, but never read it back.

Some values are meant to be public, such as the Google Maps key and the spam protection site key. Those show as plain text, and your site uses them in visitors' browsers. Site settings has a read-only **Integrations (public)** tab that lists them.

### Save your changes

Choose **Save** at the top right. Everything you changed, on every card, is saved together. Most changes work right away.

To leave without saving, choose **Cancel**.

## Fetchski services

These cards link your site to other Fetchski products.

**FetchskiAI**: the account behind every FetchskiAI feature. Fetchski sets it up, so the card reads **Managed by Fetchski** and never shows the key. Its **FetchskiAI budget** shows how much of your site's AI spending limit is used. Choose **Read again** to refresh it.

If FetchskiAI isn't set up yet, the card says so: contact Fetchski Support. If Fetchski lets your Owners manage the key, Owners also see a **FetchskiAI key** field here, sealed like any other key.

**Code Sandbox**: where FetchskiAI can run small programs safely. Fetchski sets it up and manages it, and the card says **Managed by Fetchski**. If it isn't set up, the card asks you to contact Fetchski Support. See [Code Sandbox](https://docs.fetchski-attract.com/fetchskiai/code-sandbox.md).

**GitHub**: optional, and most sites never need it. FetchskiAI can install [Skills](https://docs.fetchski-attract.com/fetchskiai/skills.md) (ready-made instructions) from GitHub, which allows only so many downloads an hour. Add a **GitHub token for installing Skills (optional)** only if installing a Skill says GitHub's hourly limit is used up.

To make the token, sign in to GitHub and open **Settings** → **Developer settings** → **Personal access tokens** → **Fine-grained tokens** → **Generate new token**. Give it a name, choose **Public repositories** for its access, add no permissions, and generate it. Copy the token, paste it into the field, and choose **Save**.

The GitHub card waits until FetchskiAI is on: it says "Turn on FetchskiAI in FetchskiAI settings before setting this up." and offers **Open FetchskiAI settings**.

**Fetchski Engage**: only if your business uses Fetchski Engage. Linking takes two steps:

1. Paste the web address you open Fetchski Engage at (such as `https://engage.example.com`) into **Fetchski Engage address**, and choose **Save**. The badge reads **Linked**, and your Privacy Policy gains a short section about Fetchski Engage.
2. Create an API key for Engage, so it can read your site's visit and conversion data. See [API keys and webhooks](https://docs.fetchski-attract.com/guides/connections/api-keys-and-webhooks.md). If you're not sure where Engage takes that key, contact Fetchski Support.

## Related screens

Three smaller screens hold settings that need no outside account. You open them from the command palette, or from **More connections** at the bottom of the list on the left of Connections. Moving between them keeps your unsaved changes, and **Save** saves them all.

> [card] [Visitor data](https://docs.fetchski-attract.com/guides/connections/request-log.md)
>
> **Request log** and **Conversions**, what your site records about visits (T then Shift+V). Conversions are covered in [Conversion tracking](https://docs.fetchski-attract.com/guides/connections/conversion-tracking.md).

> [card] [FetchskiAI settings](https://docs.fetchski-attract.com/fetchskiai/settings.md)
>
> turn AI on and set site-wide instructions (T then Shift+I).

> [card] [Service area map](https://docs.fetchski-attract.com/guides/site-settings/service-area-map.md)
>
> where your map's areas come from, your location and pricing (T then Shift+M).

## Where to start

Most sites set up these first, in this order:

1. [Email notifications](https://docs.fetchski-attract.com/guides/forms/email-notifications.md), so your forms can reach you.
2. [Google Business Profile](https://docs.fetchski-attract.com/guides/connections/google-business-profile.md) and [Google Reviews](https://docs.fetchski-attract.com/guides/connections/google-reviews.md), to show your reviews.
3. [Instagram](https://docs.fetchski-attract.com/guides/connections/instagram.md), if you post there.

The **Set up your site** checklist links to the right card for each step. See [Set up your site](https://docs.fetchski-attract.com/guides/get-started/set-up-your-site.md).

## Good to know

* **Connections stays private.** Only people who can open Connections see it. Visitors only ever get the public keys listed on **Integrations (public)**, never your private keys or passwords.
* **Some cards come with a version line.** You don't need it day to day. If Fetchski Support asks which version a card uses, read it from that line.
* **Lost a key?** Create a new one on the service's website, then use **Replace**.
* **Who can change what.** Admins and Owners can open and save Connections. See [What each role can do](https://docs.fetchski-attract.com/guides/people/what-each-role-can-do.md).

## Related

> [card] [Set up your site](https://docs.fetchski-attract.com/guides/get-started/set-up-your-site.md)
>
> the checklist that walks you through each connection.

> [card] [Site settings](https://docs.fetchski-attract.com/guides/site-settings/index.md)
>
> your business details, SEO and more.

> [card] [FetchskiAI](https://docs.fetchski-attract.com/fetchskiai/overview.md)
>
> the AI built into your site.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.