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

# Shopify

> Install the app, what syncs, and how often

Shopify is the only ecommerce platform LTV.ai syncs with. It supplies your customers, orders, and [product catalog](/brand/product-catalog).

## Install

Install LTV.ai from the Shopify App Store, or use the direct install link from your account manager. After install you land in the LTV.ai dashboard.

If your store was connected before and needs reconnecting, go to **Settings > Connections**, open **Shopify**, and choose **Reconnect my store**. Enter your `yourstore.myshopify.com` address and complete the OAuth prompt.

## Permissions

These are the scopes LTV.ai's email features rely on.

| Scope                                             | Why                                                                                                        |
| ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| `read_customers`, `write_customers`               | Customer profiles, tags, and opt-in status. Write access keeps unsubscribe status in sync with your store. |
| `read_orders`, `read_all_orders`                  | Purchase history for segmentation and [attribution](/measure/attribution)                                  |
| `write_products`                                  | Product details for grids and recommendations                                                              |
| `read_inventory`                                  | Stock levels on your product catalog                                                                       |
| `read_content`                                    | Collections and storefront content                                                                         |
| `read_metaobjects`, `read_metaobject_definitions` | Shopify custom attributes, where enabled                                                                   |
| `write_discounts`                                 | Creates discount codes for campaigns that use them                                                         |

The install screen also lists `read_checkouts`, `write_orders`, `read_returns`, `read_fulfillments`, `read_customer_payment_methods`, `read_shopify_payments_disputes`, and `write_own_subscription_contracts`. These belong to the shared ShopToken platform app rather than to LTV.ai's email features.

## What syncs

<CardGroup cols={3}>
  <Card title="Customers" icon="user">
    Profiles, location, email subscription status, and customer tags.
  </Card>

  <Card title="Orders" icon="receipt">
    New orders, full purchase history, status changes, cancellations, and refunds.
  </Card>

  <Card title="Products" icon="box">
    Details, images, descriptions, pricing, inventory, and collections.
  </Card>
</CardGroup>

LTV.ai also reads Shopify metafields and metaobjects if you enable custom attributes. See [Brand DNA](/brand/brand-dna).

## How often it syncs

LTV.ai combines webhooks for live events with scheduled jobs for bulk data.

| Data                             | How it updates           |
| -------------------------------- | ------------------------ |
| Initial sync after install       | Starts within 15 minutes |
| Orders, refunds, and fulfilments | Webhook, near real time  |
| Product deletions                | Webhook, near real time  |
| Product catalog                  | Every 30 minutes         |
| Customers                        | Every 12 hours           |
| Collections                      | Once a day               |
| Bulk sync processing             | Every 5 minutes          |

<Warning>
  Customer records are not updated in real time. A new subscriber in Shopify can take up to 12 hours to become targetable in LTV.ai. If you need someone included in a campaign sooner, upload them as a list. See [Lists](/audience/lists).
</Warning>

A large catalog change can take up to 30 minutes to appear. If products look wrong or missing, open **Settings > Connections > Shopify** and use the catalog health card to trigger a re-sync.

## Signing in

The LTV.ai dashboard is a separate login. Sign in with a magic link or a password at the dashboard URL. Shopify is not a sign-in provider for LTV.ai, and there is no Shopify single sign-on into the dashboard.

## Disconnecting

<Steps>
  <Step title="In LTV.ai">
    Go to **Settings > Connections**, open **Shopify**, and disconnect.
  </Step>

  <Step title="In Shopify">
    Go to **Settings > Apps and sales channels** and remove LTV.ai.
  </Step>
</Steps>

<Warning>
  Disconnecting stops all syncing. Customer data already imported stays in LTV.ai, and your [exclusion lists](/audience/exclusions) are preserved.
</Warning>