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

# Shopify

> Learn how to integrate your Shopify store's orders and inventory with Dema using our custom app distribution link.

export const HistoricalDataNote = () => <Tip>
    <strong>Historical data recommendation</strong> — For accurate forecasting, marketing-mix modeling, and cohort analytics, we recommend providing data going back to at least two years. Our default start date for data ingestion is <strong>January 1, 2023</strong>. The more historical data available, the better our ML models perform.
  </Tip>;

### Supported data types

<CardGroup cols={3}>
  <Card title="Orders" icon="file-invoice-dollar">
    Customer transactions (includes refunds & returns)
  </Card>

  <Card title="Product Catalog" icon="tags">
    Product metadata & descriptions
  </Card>

  <Card title="Inventory" icon="boxes-stacked">
    Stock levels per location
  </Card>
</CardGroup>

## Prerequisites

<HistoricalDataNote />

* Access to your Shopify store's admin dashboard
* Admin permissions to install apps in your Shopify store

The Dema app requires the following Shopify API scopes:

| Scope            | Used for                                 |
| ---------------- | ---------------------------------------- |
| `read_orders`    | Order and return/refund synchronization  |
| `read_products`  | Product catalog and inventory sync       |
| `read_inventory` | Stock level data per location            |
| `read_locations` | Warehouse / fulfillment location mapping |

## Installing the Shopify app

When your Shopify integration is ready, you'll receive a **custom app distribution link** from Dema.

To complete the installation:

1. Make sure you're logged into your Shopify store as an admin
2. Open the custom app distribution link provided by Dema
3. Review the app permissions
4. Click **Install** to authorize the app

Once installed, Dema will automatically begin syncing your orders, product catalog, and inventory data.

<Note>Ensure you're logged into the correct Shopify store before clicking the installation link.</Note>

## Completion

Once you've installed the app using the custom distribution link, your Shopify store will be connected to Dema and we'll begin syncing your orders, product catalog, and inventory data. Returns and refunds are included as part of the order sync.

## Troubleshooting and support

If you encounter any issues during this process or have questions, please reach out to our support team for assistance.

## Additional resources

* [Shopify tips & tricks](/integrations/ecommerce/shopify-faq) — Workflow guides and tips for getting the most out of the Dema–Shopify integration, including discount tracking with compare-at price.
* [Shopify Help Center](https://help.shopify.com/) — More detail on managing your Shopify store and API permissions.