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

# Connect Shopify & Search Console

> How to connect Shopify and Google Search Console to Citd, what each integration unlocks, and how to manage or disconnect them.

Citd works from your public store URL alone, but connecting integrations unlocks meaningfully better analysis. This page covers both integrations — what they do, how to connect them, and how to manage them over time.

## Why connect integrations

| Integration               | What it adds                                                                                                                                       |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Google Search Console** | Real buyer-search demand flows into prompt suggestions, so Citd generates questions people actually ask rather than guesses from your site content |
| **Shopify**               | Catalog metadata enriches [Readiness](/features/analysis) scoring and gives Citd richer product context for suggestions and diagnostics            |

Both integrations are optional. You can connect them during onboarding or at any time from [Project Settings](/features/project-settings).

***

## Google Search Console

### What it does

When you connect a Search Console property, Citd syncs the top search queries for your verified site. It uses that demand signal to improve the topic and prompt suggestions it generates — prompts that already have search volume are more likely to reflect real buyer intent.

The sync runs once on connect, then refreshes periodically. You can see the number of synced queries on the integration card once the sync completes.

### How to connect

<Steps>
  <Step title="Open the integration screen">
    You can connect during onboarding at **Step 2**, or any time from [Project Settings](/features/project-settings) under **Search demand**.
  </Step>

  <Step title="Click Connect Search Console">
    Citd redirects you to Google to authorize access. Sign in with the Google account that owns the Search Console property you want to connect.
  </Step>

  <Step title="Select your property">
    Choose the verified property that matches your store URL. If you do not see it, make sure the Google account you used has access to that property in Search Console.
  </Step>

  <Step title="Return to Citd">
    After authorizing, Google redirects you back. Citd begins syncing query data immediately. The status shows **Syncing** until the first sync completes.
  </Step>
</Steps>

<Info>
  If you connect Search Console during onboarding and the initial sync is still running when you reach the analyse step, Citd waits for it to finish before generating topics and prompts. This usually takes under a minute.
</Info>

### Sync status

| Status           | What it means                                            |
| ---------------- | -------------------------------------------------------- |
| Syncing / Queued | The sync is in progress — data will appear shortly       |
| Connected        | Sync is complete and demand signals are active           |
| Disconnected     | No connection; prompts suggestions use site content only |

### Disconnect

To remove the connection, open [Project Settings](/features/project-settings), scroll to **Search demand**, and click **Disconnect**. Citd stops using Search Console data from that point; the prompts already in your workspace are not affected.

***

## Shopify

### What it does

Connecting Shopify gives Citd direct access to your product catalog. This improves:

* **[Readiness](/features/analysis) analysis** — Citd can evaluate whether your product pages are well-optimized for AI responses, checking things like descriptions, structured data, and catalog completeness
* **Prompt and topic suggestions** — product names, collections, and attributes feed into better, more specific suggestions

### Connection methods

Citd supports two ways to connect Shopify:

<Tabs>
  <Tab title="Custom app token (manual setup)">
    Use this if you are connecting from the web app rather than installing from the Shopify App Store.

    <Steps>
      <Step title="Create a custom app in Shopify admin">
        In your Shopify admin, go to **Settings → Apps and sales channels → Develop apps**. Create a new app and enable the Admin API with `read_products` and `write_products` scopes. Refer to the [Shopify docs](https://shopify.dev/docs/apps/build/authentication-authorization/access-tokens/generate-app-access-tokens-admin) for step-by-step instructions.
      </Step>

      <Step title="Copy your shop domain and API token">
        Your shop domain is in the format `your-store.myshopify.com` — use the `.myshopify.com` domain, not your custom domain. The Admin API access token starts with `shpat_`.
      </Step>

      <Step title="Enter both in Citd">
        During onboarding **Step 2**, or in [Project Settings](/features/project-settings) under **Store access**, enter the shop domain and paste your access token, then click **Connect with Admin API token**.
      </Step>
    </Steps>

    <Warning>
      Store the access token securely. Citd only stores it to make catalog API calls. If you revoke the token in Shopify, you will need to reconnect with a new one.
    </Warning>
  </Tab>

  <Tab title="Shopify App (from App Store)">
    If you install Citd directly from the Shopify App Store, store access is granted automatically during the OAuth install flow. You will see "Store access was granted during install" on the integration card — no token entry needed.

    See [Using Citd inside Shopify](/setup/shopify-app) for the full install walkthrough.
  </Tab>
</Tabs>

### After connecting

Once connected, Citd shows the connection status and your shop domain on the integration card. You can:

* **Sync catalog** — trigger a fresh catalog pull to pick up new products or collection changes
* **Check sync status** — see when the last sync ran and whether it completed
* **Disconnect** — remove the connection from [Project Settings](/features/project-settings) under **Store access**

### Disconnect

Open [Project Settings](/features/project-settings), scroll to **Store access**, and click **Disconnect**. This removes Citd's API access to your catalog. Your existing prompts and topics are not affected.

***

## Managing integrations after onboarding

Both integrations are accessible from [Project Settings](/features/project-settings) at any time. Visit that page to:

* connect an integration you skipped during onboarding
* resync after a major catalog update
* disconnect and reconnect with new credentials

***

## Next steps

<CardGroup cols={2}>
  <Card title="Set up your project" icon="rocket" href="/setup/onboarding">
    Walk through the full onboarding flow step by step.
  </Card>

  <Card title="Using Citd inside Shopify" icon="shopping-bag" href="/setup/shopify-app">
    Install and use Citd as an embedded app inside Shopify admin.
  </Card>

  <Card title="Project Settings" icon="settings" href="/features/project-settings">
    Manage integrations, billing, and brand profile after onboarding.
  </Card>

  <Card title="Analysis" icon="search" href="/features/analysis">
    See how Shopify data powers Readiness scoring and competitive gap analysis.
  </Card>
</CardGroup>