---
title: Content sync configuration
related:
  - https://docs.kentico.com/documentation/business-users/content-sync.md
  - https://docs.kentico.com/documentation/business-users/content-hub/content-items.md
  - https://docs.kentico.com/documentation/business-users/website-content.md
---

> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).

> **License:** Advanced license required.
>
> Features described on this page require the Xperience by Kentico **Advanced** license tier.

Content synchronization allows users to easily transfer content from one instance of Xperience by Kentico to another.

The purpose of content sync is to help manage content when using multiple environments. For example, a project's developers may have a local **Development** instance, from which initial content is sent to a hosted **Staging** instance. The staging instance is accessible only by editors and other staff, who use it to prepare content updates. The final content is then synchronized during regular releases to a public-facing **Production** instance.

This page describes how to set up and configure your applications to use content sync:

1. [Learn about the supported environment topologies](#supported-topologies)
2. Set up content sync connections between environments:
   - [Local environments and private cloud deployments](#set-up-content-sync)
   - [SaaS deployment environments](#content-sync-for-saas-environments)
3. [Configure Xperience features and data for content sync](#configure-xperience-for-content-sync)
4. [Design your content model to avoid overwriting data on the target instance](#content-modeling-for-content-sync)

To learn how to synchronize content, see [Content sync](https://docs.kentico.com/documentation/business-users/content-sync.md).

## Supported topologies

Before you start [setting up content sync](#set-up-content-sync), it is important to understand which environment topologies are supported.

The most basic usage of content sync consists of a connection between one **source** instance and one **target** instance. Such connections can be chained to additional instances – a target can be configured as the source for another instance. However, only strictly linear topologies are supported. For example:

![Example of a supported content sync topology](https://docs.kentico.com/docsassets/documentation/content-sync-configuration/content_sync_config_topology.png "Example of a supported content sync topology")

#### Unsupported topologies

More complex topologies, for example with multiple branching target connections, loops, or bi-directional connections are not supported. The system does not strictly block content sync with unsupported topologies, but it may result in inconsistencies, errors or unintentionally overwritten content.

![Examples of unsupported content sync topologies](https://docs.kentico.com/docsassets/documentation/content-sync-configuration/content_sync_topologies_unsupported.png "Examples of unsupported content sync topologies")

## Set up content sync

### Prerequisites

- Instances connected via content sync must use **exactly the same version** of Xperience (including the hotfix version).
- Target instances must run on **HTTPS** with a valid trusted certificate.
- If using [auto-scaling](https://docs.kentico.com/documentation/developers-and-admins/configuration/auto-scaling-support.md) for a [private cloud](https://docs.kentico.com/documentation/developers-and-admins/deployment/deploy-to-private-cloud.md) project with content sync, the **\~/assets** folder must be mapped to a shared storage location, such as [Azure Blob Storage](https://docs.kentico.com/documentation/developers-and-admins/api/files-api-and-cms-io/file-system-providers/azure-blob-storage.md) or [Amazon S3](https://docs.kentico.com/documentation/developers-and-admins/api/files-api-and-cms-io/file-system-providers/amazon-s3.md).

### Source and target configuration

To set up an application as the source or target in a content sync connection, configure `ContentSynchronizationOptions` using the [.NET options pattern](https://learn.microsoft.com/en-us/aspnet/core/fundamentals/configuration/options#the-options-pattern) (available in the `CMS.ContentSynchronization` namespace).

The options are separated into `Source` and `Target` configuration. The following properties must be configured:

- `Enabled` – a bool value that enables the application as a source or target for content sync.
- `Secret` – a secret key containing at least 32 characters. The same secret must be configured for the source and target applications.
- `TargetUrl` – only available for the `Source` configuration. Specify the URL where the target application is running. Must be absolute, with the HTTPS scheme, without query or fragment components.

Use [environment-specific configuration](https://learn.microsoft.com/en-us/aspnet/core/fundamentals/environments) or [IHostEnvironment extension methods](https://learn.microsoft.com/en-us/dotnet/api/microsoft.extensions.hosting.ihostenvironment) to set the correct values for each application in your environment. To learn how to identify environments for [SaaS projects](https://docs.kentico.com/documentation/developers-and-admins/saas/saas-overview.md), see [Environment identification extension methods](https://docs.kentico.com/documentation/developers-and-admins/configuration/saas-configuration.md#environment-identification-extension-methods) or [Application settings for different SaaS deployment environments](https://docs.kentico.com/documentation/developers-and-admins/development/website-development-basics/configure-new-projects.md#application-settings-for-different-saas-deployment-environments).

```csharp title="Example - Content sync configuration"
using Microsoft.Extensions.Hosting;

...

WebApplicationBuilder builder = WebApplication.CreateBuilder(args);

...

// Configures the development environment as the content sync source
if (builder.Environment.IsDevelopment())
{    
    builder.Services.Configure<ContentSynchronizationOptions>(options =>
    {
        options.Source.Enabled = true;
        // Secret key that is at least 32 characters
        // Must be the same for source and target application.
        options.Source.Secret = "<YourSecretKey>";
        options.Source.TargetUrl = "https://productiondomain.com";
    });
}
// Configures the production environment as the content sync target
if (builder.Environment.IsProduction())
{
    builder.Services.Configure<ContentSynchronizationOptions>(options =>
    {
        options.Target.Enabled = true;
        options.Target.Secret = "<YourSecretKey>";
    });
}
```

## Content sync for SaaS environments

For [SaaS projects](https://docs.kentico.com/documentation/developers-and-admins/saas/saas-overview.md), you do not need to configure content sync manually (except for local development environments).

[SaaS deployment environments](https://docs.kentico.com/documentation/developers-and-admins/deployment/deploy-to-the-saas-environment.md#deploy-the-package-to-another-deployment-environment) have their content sync configuration done automatically based on [Content synchronization connections](#manage-synchronization-connections) defined in Xperience Portal.

> **Note:** **Xperience 30.5.0 or newer required**
>
> Content synchronization and _Staging_ environments are only available if the deployed Xperience project uses version **30.5.0** or newer.

### Content staging best practices

You can use the content sync feature to transfer content from all types of environments, including non-production ones (local development, QA, UAT). This is a viable approach during development and for small projects. However, non-production environments do not provide sufficient performance, availability, and backup policies for projects with larger content editing teams.

To set up a stable and robust environment for long-term editing and staging of content, add the optional **Staging** (STG) deployment environment to your [service plan](https://docs.kentico.com/documentation/developers-and-admins/saas/saas-service-plans.md).

The _Staging_ environment provides a platform where editors and other staff can prepare content, and then transfer it to the production environment using content sync. Staging environments are designed to be nearly identical to production environments in most aspects, such as performance, availability, backup policies, and the option to set [custom domains](https://docs.kentico.com/documentation/developers-and-admins/configuration/website-channel-management.md#manage-channel-domains-in-xperience-portal).

#### Set up a Staging environment

Use the following process to initialize a _Staging_ deployment environment for an existing project:

1. Download an [export](https://docs.kentico.com/documentation/developers-and-admins/deployment/deploy-to-the-saas-environment/manage-saas-deployments.md#restore-points-and-exports) of your production environment.
2. Create a new [deployment package](https://docs.kentico.com/documentation/developers-and-admins/deployment/deploy-to-the-saas-environment.md#create-a-deployment-package).
   - Make sure that the package contains all required data by editing the **$CDRepository/repository.config** file (see [Configure CI/CD repositories](https://docs.kentico.com/documentation/developers-and-admins/ci-cd/configure-ci-cd-repositories.md)).
   - If you are updating to version 30.5.0 or newer as part of this deployment, you must include the `cms.user` object type in the package and use the `CreateUpdate` [restore mode](https://docs.kentico.com/documentation/developers-and-admins/ci-cd/configure-ci-cd-repositories.md#configure-cd-restore-mode) (`Create` is not sufficient).
3. Deploy the package through the available environments up to _Staging_ (STG).
4. Configure any required [custom domains](https://docs.kentico.com/documentation/developers-and-admins/configuration/website-channel-management.md#manage-channel-domains-in-xperience-portal) for the staging environment.

### Manage synchronization connections

To use content sync for SaaS projects, you need to create synchronization connections between environments in [Xperience Portal](https://docs.kentico.com/documentation/developers-and-admins/saas/xperience-portal.md):

> **Note:** **Limitations**
>
> The limitations described in [Supported topologies](#supported-topologies) apply for content sync between SaaS environments. Only linear connection chains are supported, without multiple branching target connections, loops, or bi-directional connections.
>
> The connected environments must be running exactly the same version of Xperience by Kentico.
>
> Connections from SaaS environments to external private cloud instances are not supported. The only instance outside of SaaS environments that can participate in a content sync connection is a LOCAL development environment used as a source.

1. Open the **Content synchronization** application in Xperience Portal.
2. Select **Create new connection**.
3. Choose the **Source** and **Target environment**.
   - When setting up a **LOCAL** development environment as the source, see [Add connections from local development environments](#add-connections-from-local-development-environments).
4. Select **Create**.

![Adding a content synchronization connection](https://docs.kentico.com/docsassets/documentation/content-sync-configuration/SaaS_content_sync_connections.png "Adding a content synchronization connection")

After you create connections, select the **Apply changes** button in the information ribbon at the top of the interface. Applying these changes triggers a restart of the affected applications. You may need to manually refresh the current page for the _Apply changes_ button to appear in the information ribbon.

Once the connection becomes **Active**, content sync is configured for the given environments and users can start [transferring content](https://docs.kentico.com/documentation/business-users/content-sync.md).

You can delete connections and apply the changes if you wish to disable content synchronization between the given environments.

### Add connections from local development environments

When you create a [content sync connection](#manage-synchronization-connections) with a **LOCAL** environment as the source, Xperience Portal displays **Target URL** and **Connection secret** values. Copy the values and use them in the [content sync configuration](#source-and-target-configuration) of the application in your local development environment:

- Target URL → `ContentSynchronizationOptions.Source.TargetURL`
- Connection secret → `ContentSynchronizationOptions.Source.Secret`

> **Note:** The **Connection secret** value is not stored and cannot be displayed again in the future. If you lose the secret, you need to delete the connection and create a new one.

You need to ensure that the source configuration only applies to the local development environment. To learn how to identify environments for SaaS deployment environments, see [Environment identification extension methods](https://docs.kentico.com/documentation/developers-and-admins/configuration/saas-configuration.md#environment-identification-extension-methods) or [Application settings for different SaaS deployment environments](https://docs.kentico.com/documentation/developers-and-admins/development/website-development-basics/configure-new-projects.md#application-settings-for-different-saas-deployment-environments).

## Configure Xperience for content sync

To prepare your Xperience instances for content sync, configure the following features:

- Permissions
  - To synchronize content items, users need to have a role with the **Synchronize** [permission](https://docs.kentico.com/documentation/developers-and-admins/configuration/users/role-management.md) assigned for the **Content hub** application and the appropriate [workspaces](https://docs.kentico.com/documentation/developers-and-admins/configuration/users/role-management/workspaces.md).
  - To synchronize website channel pages, users need to have a role with the **Synchronize** [permission for individual pages](https://docs.kentico.com/documentation/developers-and-admins/configuration/users/role-management/page-permission-management.md) or the **Manage permissions** permission for the website channel.
  - To synchronize forms, users need to have a role with the **Synchronize** [permission](https://docs.kentico.com/documentation/developers-and-admins/configuration/users/role-management.md) assigned for the **Forms** application.
- [Workflows](https://docs.kentico.com/documentation/developers-and-admins/configuration/workflows.md) – if you use workflows to control the lifecycle of your content, only set up and apply the workflow on the source instance where content is edited. Any workflow applied on target content sync instances is ignored, as content items and pages are always transferred with the _Published_ or _Unpublished_ status and a completed workflow cycle.
- [Allowed asset extensions](https://docs.kentico.com/documentation/developers-and-admins/configuration/content-hub-configuration.md#customize-supported-file-types) – instances connected using content synchronization must use the same set of allowed file extensions for content item assets.
- [Allowed slash character in page vanity URLs](https://docs.kentico.com/documentation/developers-and-admins/development/routing/configure-forbidden-url-characters.md#allow-the-slash-character-in-vanity-urls) – to ensure consistent page URL behavior, instances connected using content synchronization must have the same enabled/disabled status for the slash ('/') character in page vanity URLs.
- [Content folders](https://docs.kentico.com/documentation/business-users/content-hub/content-hub-folders.md#content-folders) – instances connected using content synchronization must have the same enabled/disabled status for content folders. See [Enable content hub folders](https://docs.kentico.com/documentation/developers-and-admins/configuration/content-hub-configuration.md#enable-content-hub-folders).

### Ensure compatibility between instances

The following objects are required by content items and/or pages, but are **not** included in content synchronization:

- Channels that use the content ([website](https://docs.kentico.com/documentation/developers-and-admins/configuration/website-channel-management.md), [email](https://docs.kentico.com/documentation/developers-and-admins/digital-marketing-setup/email-channel-management.md), [headless](https://docs.kentico.com/documentation/developers-and-admins/configuration/headless-channel-management.md))
- [Content types](https://docs.kentico.com/documentation/developers-and-admins/development/content-types.md)
  - [Page restrictions](https://docs.kentico.com/documentation/developers-and-admins/development/content-types/limit-the-pages-users-can-create.md) for content types do not apply when restoring synchronized content on target instances.
  - [Image variant definitions](https://docs.kentico.com/documentation/developers-and-admins/development/content-types.md#configure-image-variants) for asset content types must also match between instances connected using content sync.
- [Languages](https://docs.kentico.com/documentation/developers-and-admins/configuration/languages.md)
- [Workspaces](https://docs.kentico.com/documentation/developers-and-admins/configuration/users/role-management/workspaces.md)
- [Member roles](https://docs.kentico.com/documentation/developers-and-admins/development/registration-and-authentication/member-roles.md) – member role definitions must exist on all connected instances if content items use role-based access restrictions. The system matches member roles between instances by their GUID and code name.

You need to ensure that all instances connected through content sync have exactly the same set of these objects. For example, an error will occur if you try to synchronize a content item for which an exactly matching [content type](https://docs.kentico.com/documentation/developers-and-admins/development/content-types.md) or member role is not available on the target.

The compatibility of objects is calculated based on their GUID identifiers and all available data. It is not sufficient to manually recreate objects with the same code name (with the exception of [languages](https://docs.kentico.com/documentation/developers-and-admins/configuration/languages.md), which are only validated by their code name). When you update or add any of the required objects on the source server, you need to transfer them to the next environments using other deployment methods, i.e., [SaaS deployment via a deployment package](https://docs.kentico.com/documentation/developers-and-admins/deployment/deploy-to-the-saas-environment.md#deploy-with-a-deployment-package) or [Continuous Deployment](https://docs.kentico.com/documentation/developers-and-admins/ci-cd/continuous-deployment.md).

> **Note:** **Project code compatibility requirements**
>
> To enable synchronization of [website channel pages](https://docs.kentico.com/documentation/business-users/website-content.md) and [forms](https://docs.kentico.com/documentation/business-users/digital-marketing/forms.md), you also need to deploy via [SaaS deployment package](https://docs.kentico.com/documentation/developers-and-admins/deployment/deploy-to-the-saas-environment.md#deploy-with-a-deployment-package) or [Continuous Deployment](https://docs.kentico.com/documentation/developers-and-admins/ci-cd/continuous-deployment.md) to transfer all code components related to pages and forms.
>
> This includes page views, controllers, [routing configuration](https://docs.kentico.com/documentation/developers-and-admins/development/routing/content-tree-based-routing/set-up-content-tree-based-routing.md), [Page Builder components](https://docs.kentico.com/documentation/developers-and-admins/development/builders/page-builder.md), Form Builder [components](https://docs.kentico.com/documentation/developers-and-admins/development/builders/form-builder/form-components.md) and [sections](https://docs.kentico.com/documentation/developers-and-admins/development/builders/form-builder/form-sections.md), etc.

### Synchronization of linked content

Synchronization of linked content items, pages, and forms relies on the system's usage tracking features:

- [Track usage of content items](https://docs.kentico.com/documentation/business-users/content-hub/content-items.md#track-usage-of-content-items)
- [Track page usages](https://docs.kentico.com/documentation/business-users/website-content/track-page-usages.md)
- [Track usage of forms](https://docs.kentico.com/documentation/business-users/digital-marketing/forms/create-and-edit-forms.md#track-usage-of-forms)

The limitations described for usage tracking also apply to content sync. Content items, pages or forms that are "linked" in an untracked manner are not automatically synchronized together with the linking item or page.

By default, all tracked linked content is included in the synchronization automatically. Users can open [Detailed selection](https://docs.kentico.com/documentation/business-users/content-sync.md#detailed-selection) in the synchronization dialog to review selectable dependencies and exclude specific linked items before starting the synchronization. The usage tracking limitations described above still apply – detailed selection only shows dependencies that were detected through tracked references.

If your Xperience by Kentico instance was updated from an older version, you need to manually run the following [scheduled tasks](https://docs.kentico.com/documentation/developers-and-admins/customization/scheduled-tasks.md) to track the missing content item or form usages:

- **Track missing content item usages** scheduled task
  - Generates content item and page usage references when updating from a version older than **29.3.0**
- **Track missing object usages** scheduled task
  - Generates form usage references when updating from a version older than **30.11.0**
- **Track missing object usages** scheduled task
  - Generates form usage references for [extended form widgets](https://docs.kentico.com/documentation/developers-and-admins/development/builders/page-builder/widgets-for-page-builder/extend-widgets.md), custom widgets with form selectors, and widget properties [marked for form reference tracking](https://docs.kentico.com/documentation/developers-and-admins/customization/extend-the-administration-interface/ui-form-components/ui-form-component-reference-extractors.md#assign-form-reference-tracking-to-page-builder-component-properties) when updating from a version older than **31.2.0**

## Content modeling for content sync

When designing the [content model](https://docs.kentico.com/guides/architecture/content-modeling/content-modeling-guide.md) of a project that uses content sync, distinguish between two types of data:

- **Source-owned data** – edited on the source instance (e.g., _Staging_) and transferred to the target instance (e.g., _Production_) using content sync. For example, article text, product names, descriptions, or images maintained by editors.
- **Operational data** – created or updated directly on the target instance, typically automatically by the application, a scheduled task, or an external integration. For example, ratings and counters for product stock or event registrations.

Content sync always transfers the complete latest published version of each content item or page. Individual fields cannot be excluded from the synchronization.

> **Note:** **Do not mix source-owned and operational fields in a single content type**
>
> If a content type contains both source-owned and operational fields, every synchronization of the given items overwrites the operational values on the target instance with the values from the source instance.
>
> For example, consider an _Event_ content type with a _Description_ field edited by content editors and a _RegistrationCounter_ field updated automatically on the production instance. When an editor updates the description on the staging instance and synchronizes the event content item, the current registration counter value on production is replaced by the empty or outdated value stored on staging.

To prevent overwrites, model source-owned and operational data as **separate objects**:

1. Keep source-owned fields in [content types](https://docs.kentico.com/documentation/developers-and-admins/development/content-types.md) that are edited on the source instance and synchronized (e.g., _Event_).
2. Store operational fields in a separate object whose items are only created and updated on the target instance:
   - a separate content type (e.g., _Event registrations_), if you need content item features such as [language variants](https://docs.kentico.com/documentation/developers-and-admins/configuration/languages.md) and versioning.
   - a custom [object type](https://docs.kentico.com/documentation/developers-and-admins/customization/object-types.md) (module class), if the data is purely operational and does not require content item features. This option also removes the risk of the data being edited or synchronized as content.
3. Connect the two objects and combine their data when retrieving content in your code:
   - When using a separate content type, add a [content item reference](https://docs.kentico.com/documentation/business-users/content-hub/content-items.md#link-content-items) field to the **operational** content type, pointing to the source-owned item. Do not add the reference to the source-owned content type – the operational items do not exist on the source instance, so the reference could not be filled in and synchronized.
   - When using a custom object type, store the identifier of the source-owned content item (for example its GUID) in a selector field of the object type.

> **Note:** The content types and object types that hold your operational data must exist on **all** instances connected using content sync, even if their items are only created on the target instance. Content types and object types are part of the project's code and data, and must be transferred using [SaaS deployment packages](https://docs.kentico.com/documentation/developers-and-admins/deployment/deploy-to-the-saas-environment.md#deploy-with-a-deployment-package) or [Continuous Deployment](https://docs.kentico.com/documentation/developers-and-admins/ci-cd/continuous-deployment.md).
>
> Make sure that editors do not create or edit operational items on the source instance – you can restrict access using [permissions](https://docs.kentico.com/documentation/developers-and-admins/configuration/users/role-management.md) and [workspaces](https://docs.kentico.com/documentation/developers-and-admins/configuration/users/role-management/workspaces.md).

## Content sync internals

When a target application receives content through content sync, the updates are not immediately applied. Every synchronization is represented and stored in the following way:

- Data and asset files stored in the project's `~/assets/synchronizations` folder
- Synchronization task (stored in the `CMS_Synchronization` database table)

The synchronizations are applied automatically by the _Content sync restoration_ [scheduled task](https://docs.kentico.com/documentation/developers-and-admins/customization/scheduled-tasks.md), which runs every 30 seconds. During the restoration, content is created or updated using the Xperience API:

- All content operations are performed in the context of the **kentico-system-service** ("System service user") internal [user](https://docs.kentico.com/documentation/developers-and-admins/configuration/users.md) account. Permissions are not evaluated.
- If an error occurs during the restoration, any updates that affect published content are rolled back. In some cases, added or modified _Draft_ versions of content may remain after a failed synchronization restoration.
- [Global events](https://docs.kentico.com/documentation/developers-and-admins/customization/handle-global-events.md) are triggered for the changes. The API is called in multiple waves when restoring content:
  1. Content items and pages are first created or updated in the _Draft_ status.
  2. Items and pages are published or unpublished (depending on the status of the synchronized content).
- [Workflow events](https://docs.kentico.com/documentation/developers-and-admins/customization/handle-global-events/reference-global-system-events.md#workflow-events) are not triggered (having [workflows](https://docs.kentico.com/documentation/developers-and-admins/configuration/workflows.md) applied on target content sync instance is not recommended)

You can monitor synchronizations that recently occurred or are scheduled to take place in the **Content synchronization** application.

![View planned or performed synchronizations](https://docs.kentico.com/docsassets/documentation/content-sync-configuration/content_sync_tasks.png "View planned or performed synchronizations")

> **Info:** **Synchronization cleanup**
>
> The _Content sync clean data_ scheduled task automatically cleans up synchronizations once per day. During the cleanup, synchronizations with the _Failed_ or _Completed_ status are removed. In rare cases, a synchronization may get stuck in one of the other transitional statuses that occur during restoration. Such tasks are cleaned up if they are older than 24 hours.

## Troubleshoot content sync

If you encounter any issues or errors when using content sync, you can use the system's [logging](https://docs.kentico.com/documentation/developers-and-admins/development/logging.md) functionality to analyze the content sync process. Content sync provides structured logging data during all steps of the process, including content preparation and transfer on the source instance and content restoration on the target instance.

To view the full content sync logs, your preferred logging provider must be [configured](https://docs.kentico.com/documentation/developers-and-admins/development/logging.md#configure-logging) in the following way:

- **Log level**: `Debug` or higher
- **Log categories**:
  - `CMS.ContentSynchronization`
  - `CMS.Websites`
  - `CMS.ContentEngine`\
    (for simplicity, you can adjust the configuration for all log categories starting with `CMS`)

The logs should help you identify the source of your issue, and can be helpful when describing the problem to [Kentico support](https://xperience.io/services/support).

> **Tip:** **Troubleshooting without the administration**
>
> If your target production server is [deployed without the administration](https://docs.kentico.com/documentation/developers-and-admins/deployment/deploy-to-private-cloud/deploy-without-the-administration.md), the built-in [Event log](https://docs.kentico.com/documentation/developers-and-admins/configuration/event-log.md) is not available for troubleshooting content restoration. To work around this, you can add a [custom logging provider](https://docs.kentico.com/documentation/developers-and-admins/development/logging.md#custom-logging-providers) to your application and view troubleshooting data externally (e.g., using Serilog, NLog, or Aspire dashboard).

If your logging provider supports [distributed tracing](https://learn.microsoft.com/en-us/dotnet/core/diagnostics/distributed-tracing), you can enable collection of content sync activities by adding the `Kentico.Xperience.ContentSynchronization` source to your tracing configuration. For example:

```csharp title="Program.cs"
using Microsoft.Extensions.Logging;
using OpenTelemetry.Logs;
using OpenTelemetry.Trace;

// ...

var builder = WebApplication.CreateBuilder(args);

// ...

builder.Services.AddLogging(logging =>
{
    logging.AddOpenTelemetry(options =>
    {
        // ...
    });
});

// Configures OpenTelemetry tracing
builder.Services.AddOpenTelemetry()
    .WithTracing(t => t
        // Adds the source for content sync activities
        .AddSource("Kentico.Xperience.ContentSynchronization") 
        .AddAspNetCoreInstrumentation()
        .AddOtlpExporter());
```