# Sync your Shopify inventory with Talon.One

> Let's set up Shopify to sync your product inventory with a cart item catalog in Talon.One.

> For the complete documentation index, see [llms.txt](https://docs.talon.one/llms.txt).

## Talon.One requirements

- You are an [admin](/docs/product/account/account-settings/manage-roles.md#admin-role)
  user.
- You have set up an [Application](/docs/product/applications/create-and-manage-applications.md).
- You have created a
  [Third-party API key](/docs/product/applications/manage-third-party-api-keys.md#create-a-third-party-api-key)
  for use with Shopify.

## Shopify requirements

- You are an
  [administrator](https://help.shopify.com/en/manual/your-account/staff-accounts/staff-roles/staff-roles-descriptions)
  user.
- You have completed the
  [basic setup](set-up-shopify-app.md) of the Talon.One
  Shopify app.

## Set up the integration

<StepsContainer>

### Connect a cart item catalog

1. Create a
   [cart item catalog](/docs/product/account/dev-tools/manage-cart-item-catalogs.md#create-a-cart-item-catalog)
   and connect it to your Application. Remember the catalog ID, for example, `34`.
   :::tip
   To see the catalog ID, click <Account className="icon"/> **Account** > <Tools
   className="icon"/> **Tools** > **Cart Item Catalogs**.

   The ID is displayed in the second column of the
   [list](/docs/product/account/dev-tools/manage-cart-item-catalogs.md#list-cart-item-catalogs).
   :::
1. In Shopify, open **Apps > Talon One > Product data sync**.
1. In **Catalog ID**, enter the ID of the cart item catalog you created, for example,
   `34`.
1. Ensure the product attributes and metafields are
   [configured](set-up-shopify-app.md#configure-product-data-sync) as needed.
1. Click **Save**.

### Verify the initial product sync

Setting the catalog ID to any other value than `0` and saving the changes starts an
[initial product sync](integrate-with-shopify.md#product-data).

Refresh your
[catalog page](/docs/product/account/dev-tools/manage-cart-item-catalogs.md#display-a-cart-item-catalog)
in Talon.One until you see new products being added. If nothing changes within a few
minutes, see [Troubleshooting](#troubleshooting).

The full sync may take several minutes, or even hours if you have millions of products.
The process will continue in the background.

After the sync is complete, your cart item catalog contains the products from your Shopify
catalog.

### Next steps

You can now use your synchronized cart item catalog, for example, to
[apply strikethrough pricing](/docs/dev/technology-partners/shopify/apply-strikethrough-effects-shopify.md)
to your Shopify products.

</StepsContainer>

## Considerations when syncing collections

If you are using [collections](https://help.shopify.com/en/manual/products/collections) in
Shopify to organize your products and want to sync them with Talon.One, keep the following
considerations in mind:

- Syncing collections must be explicitly enabled for your account. For more information,
  contact your Customer Success Manager.
- Before syncing, a custom cart item attribute named `collections` must
  [exist](set-up-shopify-app.md#prerequisites) in Talon.One.
- After syncing, the `collections` attribute contains a list of collections to which a
  product belongs in Shopify.
- When you remove a product from a collection in Shopify, the `collections` attribute is
  **not** updated. To trigger an update, change the product in Shopify, for example by
  updating its description.
- The integration supports both
  [manual and smart collections](https://help.shopify.com/en/manual/products/collections/collection-types).
  However, there's a limitation regarding smart collections. When you create or update a
  product, and it matches or no longer matches the criteria of an existing smart
  collection, the `collections` attribute in Talon.One is **not** updated.

## Troubleshooting

If some or all of your products are missing from the cart item catalog, do the following:

1. Open the [Integration API logs](/docs/product/account/logs/integration-api-logs.md).
1. Click **Filter** > **Application** > **[Name of your Application]**.
1. Click **Filter** > **Status** > **Error**.
1. Next to the most recent entry with the path `/v1/catalogs/1/sync`, click **+**.
1. Open the **Response** tab and check the error messages:
   - If there are `Attribute not found` error messages,
     [create](set-up-shopify-app.md#prerequisites) the missing attributes in
     Talon.One. As soon as the attributes are created, the sync restarts.
   - If there are other error messages, contact your Customer Support Manager.