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

# Shopify Connector

<Badge icon="arrow-left" color="gray">[Back to Search AI connectors list](/ai-for-service/searchai/content-sources#supported-connectors)</Badge>

Shopify is a leading e-commerce platform for creating online stores and selling products or services. The Shopify connector ingests blog articles from your Shopify account into Search AI, using either a API access token or OAuth client credentials.

| Specification     | Details       |
| ----------------- | ------------- |
| Repository type   | Cloud         |
| Supported content | Blog Articles |
| RACL support      | No            |
| Content filtering | No            |

## Prerequisites

* An admin account on Shopify.
* A Shopify custom app, created using one of the following methods, depending on the authorization type you plan to use:
  * **Legacy custom app**, created from the Shopify Admin, for **API Access Token** authorization.
  * **Dev Dashboard app**, created from the Shopify Dev Dashboard or CLI, for **Client Credentials (OAuth 2.0)** authorization.

## Step 1: Configure Authentication on Shopify

Choose the setup method that matches your custom app type.

### Option A: API Access Token (legacy custom apps)

1. Sign in to the Shopify admin portal.
2. Go to **Apps and Sales Channels**.
3. Click **Develop apps** and create an app.
4. Enter the app name and details.
5. Enable the following admin scope and click **Save**:
   * `read_content`
6. Go to the **API Credentials** tab and click **Install app** to generate an access token. This token is used to configure the Search AI connector.

### Option B: Client Credentials (OAuth, Dev Dashboard apps)

1. Sign in to the Shopify Dev Dashboard.
2. Create a new app, or select an existing one.
3. Enable the following admin scope:
   * `read_content`
4. Go to the app's **Client Credentials** section and note the **Client ID** and **Secret**.
5. Note your store's **Store Domain** (for example, `yourstore.myshopify.com`).

## Step 2: Configure the Search AI Connector

Go to **Content > Connectors** and select the **Shopify** connector. On the **Authentication** tab, select an **Authorization Method** and enter the corresponding fields.

### API Access Token

| Field                    | Description                               |
| ------------------------ | ----------------------------------------- |
| **Name**                 | Unique name for the connector             |
| **Store Host URL**       | URL of your Shopify store                 |
| **Authorization Method** | API Access Token                          |
| **API Key**              | Access token generated in the Shopify app |

Select **Connect** to authenticate.

### Client Credentials (OAuth)

Enter the corresponding fields:

| Field                    | Description                                      |
| ------------------------ | ------------------------------------------------ |
| **Name**                 | Unique name for the connector                    |
| **Store Host URL**       | URL of your Shopify store                        |
| **Authorization Method** | Client Credentials (OAuth)                       |
| **Client ID**            | Client ID from the Shopify Dev Dashboard app     |
| **Client Secret**        | Client Secret from the Shopify Dev Dashboard app |

Select **Connect** to save the connector.

<NOTE>On save, Search AI performs a token exchange with Shopify and securely stores the resulting access token. The connector passes this token as the `Authorization: Bearer {token}` header on all subsequent API calls, and automatically refreshes the token before it expires so the connection stays active without manual intervention.</NOTE>

## Content Ingestion

The connector ingests blog articles from your Shopify account. Only articles that are published or visible at the time of sync are ingested. If an article's visibility status changes after a sync, the update is reflected in Search AI only after the next sync.

The ingested document contains:

* **Content field** - Textual content of the blog article.
* **Metadata fields** - Author, labels, and URL, each captured in individual fields.
