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

# Shopify Integration

> Connect your Shopify store to sync customers, orders, and products

The Shopify integration connects your store to RevBridge AI, enabling personalized marketing based on real customer behavior and purchase history.

## What Gets Synced

| Data                    | Description                 | Use In RevBridge               |
| ----------------------- | --------------------------- | ------------------------------ |
| **Customers**           | Contact info, tags, notes   | People profiles, segmentation  |
| **Orders**              | Transactions, items, status | Revenue tracking, RFM analysis |
| **Products**            | Catalog, variants, prices   | Recommendations, campaigns     |
| **Abandoned Checkouts** | Incomplete carts            | Recovery campaigns             |

## Connecting Shopify

### Prerequisites

* Shopify store with admin access
* Store on Shopify Basic plan or higher
* RevBridge AI account

### Connection Steps

<Steps>
  <Step title="Navigate to Integrations">
    Go to **Data → Integrations** from the sidebar
  </Step>

  <Step title="Click Connect Shopify">
    Find Shopify in the integration list and click **Connect**
  </Step>

  <Step title="Enter Store Name">
    Enter your Shopify store subdomain

    * Example: For `mystore.myshopify.com`, enter `mystore`
  </Step>

  <Step title="Authorize Access">
    You'll be redirected to Shopify

    * Log in if needed
    * Review the permissions requested
    * Click **Install app**
  </Step>

  <Step title="Initial Sync">
    RevBridge begins importing your data

    * This may take several minutes depending on store size
    * You can navigate away; sync continues in background
  </Step>
</Steps>

<Check>
  After connecting, verify the integration shows **Connected** status and customer count appears in your Data Overview.
</Check>

## Permissions Requested

RevBridge AI requests the following Shopify scopes:

| Scope            | Purpose                  |
| ---------------- | ------------------------ |
| `read_customers` | Import customer profiles |
| `read_orders`    | Import order history     |
| `read_products`  | Import product catalog   |
| `read_checkouts` | Import abandoned carts   |

<Info>
  RevBridge AI only requests read access. We never modify your Shopify data.
</Info>

## Data Mapping

### Customer Data

| Shopify Field | RevBridge Field |
| ------------- | --------------- |
| Email         | email           |
| First Name    | first\_name     |
| Last Name     | last\_name      |
| Phone         | phone           |
| Tags          | tags            |
| Created At    | created\_at     |
| Orders Count  | purchase\_count |
| Total Spent   | total\_revenue  |

### Order Data

| Shopify Field      | RevBridge Field     |
| ------------------ | ------------------- |
| Order Number       | order\_id           |
| Created At         | order\_date         |
| Total Price        | order\_total        |
| Line Items         | order\_items        |
| Fulfillment Status | fulfillment\_status |
| Financial Status   | payment\_status     |

### Product Data

| Shopify Field | RevBridge Field |
| ------------- | --------------- |
| Title         | product\_name   |
| Handle        | product\_slug   |
| Vendor        | brand           |
| Product Type  | category        |
| Variants      | variants        |
| Price         | price           |
| Images        | images          |

## Sync Behavior

### Initial Sync

When first connected:

* All historical customers are imported
* Order history is imported (configurable date range)
* Complete product catalog is synced
* Active abandoned checkouts are imported

### Incremental Sync

After initial sync:

* New customers sync automatically
* New orders sync automatically
* Product changes sync automatically
* Abandoned checkouts update regularly

### Sync Schedule

| Data Type       | Default Frequency |
| --------------- | ----------------- |
| Customers       | Every 6 hours     |
| Orders          | Every 6 hours     |
| Products        | Every 6 hours     |
| Abandoned Carts | Every 6 hours     |

<Tip>
  For high-volume stores, contact support about real-time webhook integration for immediate updates.
</Tip>

## Using Shopify Data

### Segmentation

Create audiences based on Shopify data:

| Segment Example       | Criteria                               |
| --------------------- | -------------------------------------- |
| **First-Time Buyers** | purchase\_count = 1                    |
| **Repeat Customers**  | purchase\_count > 1                    |
| **High-Value**        | total\_revenue > \$500                 |
| **Cart Abandoners**   | has abandoned\_checkout in last 7 days |
| **Lapsed Customers**  | last\_order\_date > 60 days ago        |

### Campaigns

Shopify data enables powerful campaign triggers:

| Trigger                   | Campaign Type      |
| ------------------------- | ------------------ |
| Abandoned checkout        | Cart recovery      |
| First order               | Welcome sequence   |
| Repeat purchase           | Loyalty rewards    |
| No purchase in 60 days    | Win-back           |
| Product view, no purchase | Browse abandonment |

### Personalization

Use Shopify data in templates:

```
Hi {{first_name}},

We noticed you left {{cart_items}} in your cart.
Complete your purchase of {{cart_total}} today!
```

## Abandoned Cart Recovery

### How It Works

1. Customer adds items to cart
2. Customer leaves without purchasing
3. Checkout data syncs to RevBridge AI
4. Customer enters abandoned cart audience
5. Recovery campaign sends automatically

### Recovery Timeline

Recommended email sequence:

| Email | Timing   | Focus          |
| ----- | -------- | -------------- |
| 1     | 1 hour   | Reminder       |
| 2     | 24 hours | Social proof   |
| 3     | 72 hours | Discount offer |

<Info>
  AI Campaigns can optimize this sequence automatically, testing different timings and messages.
</Info>

## Troubleshooting

### Integration Won't Connect

1. Verify you're logged into Shopify as admin
2. Check your store subdomain is correct
3. Ensure you're on Shopify Basic or higher
4. Try in incognito/private browsing mode

### Missing Customer Data

1. Customer may have opted out of marketing
2. Check if customer exists in Shopify
3. Wait for next sync cycle
4. Verify no sync errors in integration status

### Abandoned Carts Not Syncing

1. Only abandoned checkouts with email addresses sync
2. Guest checkouts may not have email until later
3. Check if cart abandonment is recent
4. Verify checkout was actually abandoned (no order placed)

### Sync Errors

Common error causes:

* API rate limits (usually resolves automatically)
* Permission changes (reauthorize the integration)
* Shopify outage (check Shopify status page)
* Token expiration (reconnect integration)

## Disconnecting

To disconnect the Shopify integration:

<Steps>
  <Step title="Go to Integrations">
    Navigate to **Data → Integrations**
  </Step>

  <Step title="Click Disconnect">
    Find Shopify and click **Disconnect**
  </Step>

  <Step title="Confirm">
    Confirm you want to disconnect
  </Step>
</Steps>

<Warning>
  Disconnecting stops data sync but does not delete existing data in RevBridge AI. Customer profiles remain for continuity.
</Warning>

## Best Practices

### Clean Data

* Maintain accurate customer emails in Shopify
* Use consistent tags for segmentation
* Keep product catalog organized

### Leverage Tags

Use Shopify customer tags to create segments:

* VIP customers
* Wholesale buyers
* Influencers
* At-risk customers

### Product Data

Keep product data complete:

* High-quality images
* Accurate pricing
* Proper categorization
* SEO-friendly titles

This data improves recommendation quality and campaign personalization.