---
title: "Synchronize content items"
slug: "synchronize-content-items"
abstract: "How to synchronize data between the Sitecore Content Editor and the Commerce Engine after you create a new Commerce content items (such as custom Commerce Terms), so that it is displayed in the Business Tools user interface, for example."
---
# Synchronize content items

When you add a new Commerce content item or make changes to an existing one in the [Commerce Control Panel](https://doc.sitecore.com/xp/en/developers/103/sitecore-experience-commerce/commerce-control-panel.html "Commerce Control Panel") (in the Sitecore Content Editor), you must synchronize the content item (defined in the Sitecore Content Editor) with the data in the Commerce Engine database. For example, if you add a new Commerce Term (a new item to display to Business Tools users, for example), you must synchronize the new content item so that it can be displayed on the Business Tools user interface.

You can [synchronize a single content item](https://doc.sitecore.com/xp/en/developers/103/sitecore-experience-commerce/synchronize-content-items.html#UUID-60cf6975-7402-f8b8-43a1-ca5a7cef1116_section-5d8910a5ce41f-idm46002382405664 "Synchronize a single content item") using the `Sync content item` sample API request. If there are more than one new or modified content items, then you need to [synchronize all content items](https://doc.sitecore.com/xp/en/developers/103/sitecore-experience-commerce/synchronize-content-items.html#UUID-60cf6975-7402-f8b8-43a1-ca5a7cef1116_section-5d8921ce9f48e-idm45749439070080 "Synchronize all content items in the Control Panel") by using the `Sync content path` sample request. Both requests are available in the Postman sample collections that are included in the [Sitecore Commerce Engine SDK](https://doc.sitecore.com/xp/en/developers/103/sitecore-experience-commerce/sitecore-commerce-engine-sdk.html "Sitecore Commerce Engine SDK").  

The following instructions assume that you have installed the Postman application, imported the sample collections from the Sitecore Commerce Engine SDK, configured your environment, and retrieved a bearer token to access the Commerce Engine API, as described [here](https://doc.sitecore.com/xp/en/developers/103/sitecore-experience-commerce/execute-sample-api-calls-in-postman.html "Execute sample API calls in Postman").

## Synchronize a single content item

You can use the `Sync content item` sample request in Postman when you have a single Sitecore content item to synchronize.

### Prerequisites

Before you use the `Sync content item` request in Postman, make sure to have the Sitecore content item path (URL) at hand. You need to pass this information as a parameter value when invoking the `Sync content item` request in Postman. The following shows an example of the **Content path** (URL) of a Commerce content item in the Sitecore Content Editor.

![The Item path value of a Commerce item in the Sitecore Content Editor.](https://doc.sitecore.com/api/markdown-image/xp/en/developers/103/sitecore-experience-commerce/images/Commerce_Content_Item_path.png)

To synchronize a content item between the Sitecore Content Editor and the Commerce Engine:

1. Open Postman and, in the Postman **Collections** pane, expand the *ContentAPISamples* collection.
2. Open the *Views* folder, and click on the `Sync item` request.
3. In the **Body** pane, ensure the values for the *viewName* and *forAction* parameters are both set to `SynchronizeContentItem`, and click **Send**.

    > [!note]
    > The `Sync item` request returns information on the Entity View. In the properties section for the `"Version"`, take note of the `"Value"` (shown in the following example). You must provide this information as input in a subsequent step in the `Sync content item` request.
    >
    > ![The version value property.](https://doc.sitecore.com/api/markdown-image/xp/en/developers/103/sitecore-experience-commerce/images/SyncContentPath_Version_value.png)

4. Open the *DoActions* folder, and click on the `Sync content item` request.
5. In the **Body** pane, update the `"Version"` with the value returned in the previous step, and update the `"Path"` property value with the content item path (URL) of the custom Commerce item to synchronize. The following shows an example of the property values you need to update.

    ![The "value" property for the content item version and path.](https://doc.sitecore.com/api/markdown-image/xp/en/developers/103/sitecore-experience-commerce/images/Views_version_and_path.png)

6. Click **Send**.
7. To make the content item available the Business Tools, you must flush the Redis cache. Navigate to `C:\Program Files\Redis`, run `redis-cli.exe` and execute the [flushall](https://redis.io/commands/flushall) command.

## Synchronize all content items in the Control Panel

When the Commerce Control Panel (in Sitecore Content Editor) contains multiple custom Commerce items, you use the *Sync content path* API sample to synchronize all Commerce content items.

> [!note]
> This operation deletes all Control Panel content items from the Commerce Engine, then re-copies content items from Sitecore Commerce Control Panel into the Commerce Engine content tables. The number of content items to synchronize determines the time this operation takes to complete.

To synchronize all content items:

1. In the Postman **Collections** pane, expand the *ContentAPISamples* collection.
2. Open the *Views* folder, and click on the `Sync item` request.
3. In the **Body** pane, ensure the values for the `"viewName"` and `"forAction" `parameters are set to `SynchronizeContentPath`, and click **Send**.

    > [!note]
    > The `Sync item` request returns information on the Entity View. Take note of the content item `"Version"` value, as you must provide this information as input in the `Sync content path` request.
    >
    > ![The version value property.](https://doc.sitecore.com/api/markdown-image/xp/en/developers/103/sitecore-experience-commerce/images/SyncContentPath_Version_value.png)

4. Open the *DoActions* folder, and click on the `Sync content path` request.
5. In the **Body** pane, update the version `"Value"` property with the same value as the one returned in the response to the `Sync item` request performed in [Step 3](https://doc.sitecore.com/xp/en/developers/103/sitecore-experience-commerce/synchronize-content-items.html#UUID-60cf6975-7402-f8b8-43a1-ca5a7cef1116_N1569437638159 "Step 3")

    The following shows an example of the `"Version"` property you must update in the `Sync content path request` :

    ![The "Version" property in the Sync content path request.](https://doc.sitecore.com/api/markdown-image/xp/en/developers/103/sitecore-experience-commerce/images/SyncItemPath.png)

6. Click **Send**.
7. To make the content item available in the Business Tools, you must flush the Redis cache (use the [flushall](https://redis.io/commands/flushall) command in Redis).