# Data Catalog Links Synchronization

Source: https://userguide.qualytics.io/source-datastore/data-catalog-links/deep-dive/synchronization/

A synchronization is the metadata exchange between Qualytics and the catalog over the linked assets, in two directions you choose independently. **Pull** brings supported catalog metadata into Qualytics, and **Push** sends Qualytics metadata to the catalog. Exactly what each direction exchanges depends on the catalog; every catalog's own page documents its supported asset types and outputs in its Synchronization section, listed under [Supported Data Catalogs](https://userguide.qualytics.io/settings/integrations/data-catalogs/overview/#supported-data-catalogs).

## Two Scopes

The synchronization comes in two scopes:

| Scope | Started from | Covers | Requires |
| --- | --- | --- | --- |
| Datastore-scoped | The datastore's **Data Catalog Links** dialog | The linked assets of one datastore | The **Editor** team permission on the datastore |
| Full | The integration's entry under **Settings** > **Integrations** | Every datastore of the integration where the user has the **Editor** team permission (an **Admin** covers all of them) | The **Manager** or **Admin** role |

The datastore-scoped synchronization is the fastest way to see a corrected link take effect without waiting for the next integration-wide run. A full synchronization that includes **Pull** also reconciles the lineage connections between the integration's datastores as a whole (a **Push**-only run leaves lineage unchanged), so a run started by a Manager can remove a connection that involves a datastore it skipped for lack of the **Editor** team permission. Either way, progress and results are reported on the integration's entry under **Settings** > **Integrations**.

Containers and fields do not start synchronizations. The scope is the datastore, so their dialogs point you to it.

See [Synchronization Options](https://userguide.qualytics.io/settings/integrations/data-catalogs/overview/#synchronization-options) for the integration-wide options, and the [sync how-to](https://userguide.qualytics.io/source-datastore/data-catalog-links/how-tos/sync-catalog/) for the step-by-step from the dialog.

## See Also

- **How It Works**

  Where links come from, and how manual and automatic links behave.

  [How It Works](https://userguide.qualytics.io/source-datastore/data-catalog-links/deep-dive/how-it-works/)
- **Permissions**

  The team permission and roles behind viewing, linking, and synchronizing.

  [Permissions](https://userguide.qualytics.io/source-datastore/data-catalog-links/deep-dive/permissions/)

*Last updated: October 6, 2026.*
