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

# Shopify Integration

> Connect your Shopify store via a private developer app to publish AEO-optimized articles directly to your Shopify blog.

Connect ChatFeatured to your Shopify store to publish AI-optimized buying guides, comparisons, and educational articles directly to your Shopify blog (`/blogs/news` or any custom blog) with one click.

<Info>
  **Publishing Only:** This integration publishes articles to your Shopify blog. AI crawler analytics aren't available on standard Shopify plans because Shopify manages the edge infrastructure and CDN logs directly.
</Info>

***

## Connection Requirements

To connect ChatFeatured, you will create a private app in your Shopify Developer Dashboard and provide:

* **Shopify Store Domain:** Your store's `.myshopify.com` domain (e.g., `your-brand.myshopify.com`), **not** your public storefront domain (e.g., `yourbrand.com`).
* **Client ID:** Found on your app's Settings page in the Dev Dashboard.
* **Client Secret:** Found on your app's Settings page in the Dev Dashboard. The secret is encrypted and stored securely server-side.

***

## Step-by-Step Setup Guide

Creating a private Shopify app for your store takes about 5 minutes, with no App Store listing or public review involved.

<Steps>
  <Step title="1. Create an App in the Shopify Dev Dashboard">
    1. Go to [dev.shopify.com](https://dev.shopify.com) and sign in with the account that owns your store.
    2. Open **Apps** in the sidebar navigation.
    3. Select **Create app**, then click **Start from Dev Dashboard**.
    4. Name the app anything you like (e.g., `ChatFeatured Publisher`).
    5. Select **Create**.
  </Step>

  <Step title="2. Add Permissions and Release">
    1. In your new app dashboard, open the **Versions** tab.
    2. Set the **App URL** to:
       ```http theme={null}
       https://chatfeatured.com
       ```
       *(Shopify requires an App URL to save a version; ChatFeatured never calls it).*
    3. Add the following access scopes:
       * `read_content`
       * `write_content`
    4. **Uncheck "Embed app in Shopify admin"** if the checkbox is shown.
    5. Select **Release** and confirm the new version.
  </Step>

  <Step title="3. Install the App on Your Store">
    1. After the version is released, go back to your app's **Home** tab in the Dev Dashboard (the app overview page).
    2. In the **Installs** section, select **Install app**.
    3. Choose your target store from the list, then select **Install**.

    <Tip>
      The app and your Shopify store must belong to the same Shopify organization for the installation to succeed.
    </Tip>
  </Step>

  <Step title="4. Copy Credentials and Connect in ChatFeatured">
    1. In the Dev Dashboard, open the **Settings** tab for your app.
    2. Copy your **Client ID** and **Client secret**.
    3. In your ChatFeatured dashboard, navigate to **Integrations** > **Shopify**.
    4. Enter your store's `.myshopify.com` domain, paste the **Client ID** and **Client secret**, and select **Connect**.
    5. Once connected, pick which Shopify blog ChatFeatured should publish articles to (e.g., *News* or *Blog*).
  </Step>
</Steps>

***

## Publishing Articles to Shopify

Once your store is connected, you can publish articles in two ways:

<Tabs>
  <Tab title="From the Articles Tab">
    1. Navigate to **Articles** in ChatFeatured.
    2. Open any article in **Review** or **Approved** status.
    3. Click **Publish to Shopify**.
    4. Review the auto-generated title, handle, summary excerpt, and featured image.
    5. Choose **Publish Now** or schedule it for a future date.
  </Tab>

  <Tab title="Using the AEO Agent">
    Manage your publishing queue conversationally with the [AEO Agent](/ai-agents/overview):

    * *"Publish our approved article on 'Best Ergonomic Office Chairs for Remote Workers' to our Shopify blog."*
    * *"Schedule all approved buying guides to publish to our Shopify store every Wednesday at 10 AM."*
  </Tab>
</Tabs>

***

## How Shopify Articles are Formatted

ChatFeatured formats all published content to match native Shopify blog requirements:

| Field              | Shopify Mapping        | Description                                                                                                |
| :----------------- | :--------------------- | :--------------------------------------------------------------------------------------------------------- |
| **Title**          | `Article.title`        | High-converting, AEO-optimized H1 title.                                                                   |
| **Body Content**   | `Article.body_html`    | Clean HTML formatted with semantic headings (`<h2>`, `<h3>`), tables, bullet points, and citation anchors. |
| **Featured Image** | `Article.image`        | Automatically uploaded and attached as the post hero image.                                                |
| **Excerpt**        | `Article.summary_html` | 1–2 sentence summary used on blog archive pages and feeds.                                                 |
| **Author**         | `Article.author`       | The selected default store author or custom byline.                                                        |
| **URL Handle**     | `Article.handle`       | Clean, slugified URL (e.g., `/blogs/news/best-ergonomic-chairs`).                                          |

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Error: 'Store domain must be a .myshopify.com URL'">
    Make sure you enter your permanent store domain (e.g., `my-shop.myshopify.com`) rather than your primary public custom domain (e.g., `myshop.com`). You can find this in your Shopify Admin under **Settings** > **Domains**.
  </Accordion>

  <Accordion title="Error installing app: Store not visible in Installs list">
    Ensure that the account you used to log into `dev.shopify.com` has administrator or owner access to the target Shopify store, and that both belong to the same Shopify organization.
  </Accordion>

  <Accordion title="No blogs appear in the dropdown after connecting">
    Verify that your Shopify store has at least one active blog created. In your Shopify Admin, go to **Online Store** > **Blog posts** > **Manage blogs** and confirm a blog (such as *News*) exists.
  </Accordion>
</AccordionGroup>

***

## Related Guides

<CardGroup cols={2}>
  <Card title="Content Strategy & Articles" icon="newspaper" href="/using-chatfeatured/articles">
    Generate and approve high-intent commercial articles to publish to your store.
  </Card>

  <Card title="Brand Book" icon="building" href="/using-chatfeatured/brand-book">
    Configure your brand taxonomy and buyer personas to align article topics.
  </Card>

  <Card title="Prompts Tracking" icon="message-bot" href="/using-chatfeatured/prompts">
    Track the commercial questions and product comparisons buyers ask AI engines.
  </Card>

  <Card title="All Integrations" icon="grid-2" href="/integrations/overview">
    Explore other publishing connectors including WordPress, Webflow, and Ghost.
  </Card>
</CardGroup>