---
title: Configure the Commercetools app
slug: optimizely-connect-platform/docs/configure-the-commercetools-app
docTags: 
createdAt: 2026-07-20T15:44:47.637Z
---

:::hint{type="info"}
The OCP database is not included in the free version of OCP. The free version syncs data in real-time without using the OCP database, letting you access public apps and data syncs.

Contact your Customer Success Manager if you have any questions.
:::

The Commercetools app syncs your Commercetools catalog to Optimizely Graph.  

This app imports the Commercetools product catalogue data to OCP, where you can then use the [Sync Manager](docId:9MPJ0gwsoXoAubpkwFgyD) to sync this data to your other Optimizely products.

## Install and configure the app

1. Go to **Data Setup > App Directory**.
2. Select the **Commercetools **app. 

   ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/9vbASXUT_4CnVL7JX5FsN-20260720-150148.png" size="100" isUploading="false" showCaption="false" width="1364" height="916" darkWidth="1364" darkHeight="916"}
3. Click **Install App**. The **Settings** tab displays. 

   ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/mEnd-aDvLkR4I3Migz1vb-20260720-150148.png" size="100" isUploading="false" showCaption="false"}
4. Expand the **Commercetools Connection** section, complete the following settings, and then click **Connect**.
   - **Project Key** – Enter the unique identifier for your Commercetools project.
   - **API Region** – Select the geographic region of your Commercetools project.
   - **Client ID** – Enter the client ID of your Commercetools API client.
   - **Client Secret** – Enter the client secret of your Commercetools API client.
5. Expand the **Optimizely Graph Connection** section, complete the following settings, and then click **Connect to Optimizely Graph**.
   - **App Key** – Enter the app key for your Optimizely Graph account.
   - **App Secret** – Enter the app secret for your Optimizely Graph account.
   - **Languages to Sync** – Select the languages you want to sync to Optimizely Graph. The app will create products for each language.
   - **Custom Attributes to Sync** – Select custom attributes from your Commercetools products that you want to include in the Optimizely Graph data schema. The app will sync these attributes along with standard product data.
6. Expand the **Data Synchronization** section and toggle **Enable Realtime Updates via Webhooks** on if you want the app to create webhooks in Commercetools to receive real-time updates.
7. Click **Fetch All Products Now** and **Fetch All Categories Now** to immediately sync all your Commercetools products and categories to Optimizely Graph.
8. Click **Save**. The app will start syncing your Commercetools data to Optimizely Graph.

## Sync Commercetools data to other Optimizely products

1. Go to **Data Setup > Sync Manager**.
2. Click **New Sync**.
3. Enter a **Sync Name**, like *Commercetools Products to Optimizely Graph*.
4. Complete the following for the sync source:
   - **Source** – Select **OCP database**.
   - **Object** – Select the data type that you want to sync from Bynder, like **Commercetools**.
5. Complete the selections for your sync destination:
   - If you select **Content Graph** (now called Optimizely Graph) as the product to which you want to sync your Commercetools data, you must also select the **Instance**, **Object**, **Status**, and **Language**.
   - If you select **OCP App** as the product to which you want to sync your Commercetools data, you must then select the **App** and **Object**.
6. Connect specific Commercetools fields with your chosen destination fields in the **Field Mapping** section.
   To autopopulate the field mappings based on your chosen source object, select **Inherit Source Object** in the **Object** drop-down list of the **Destination** section, and then click **Apply**.

   ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/EGMCqtMhZQLxG3VRb9pFu-20260720-150148.png" size="100" isUploading="false" showCaption="false"}
7. Toggle off any field mappings that you do not want to sync (all are on by default). 

   ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/XfijDVv85jI2DQ-f02ABD-20260720-150148.png" size="100" isUploading="false" showCaption="false"}
8. Select the **Sync Schedule** cadence. For example, select **Every 1 hour** to sync Commercetools data to your chosen destination once per hour.

   ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/3d3mTu1hjOZmyFXwzfLgK-20260720-150148.png" size="100" isUploading="false" showCaption="false"}
9. Click **Save**. Your Commercetools data now syncs to your chosen destination on your chosen schedule. 

   ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/GgbZH2gvVfivZXb7dFN2K-20260720-150148.png" size="100" isUploading="false" showCaption="false"}
10. Repeat these steps if you want to sync different Commercetools data to different destinations.