# How Container Data Catalog Links Work

Source: https://userguide.qualytics.io/container/data-catalog-links/deep-dive/how-it-works/

The **Data Catalog Links** dialog on a container shows how that table or view is linked to its counterpart asset in each connected data catalog, and lets you correct the link when the automatic match picked the wrong asset or found none. It works the same way across every connected catalog; for the list of catalogs Qualytics integrates with, see [Supported Data Catalogs](https://userguide.qualytics.io/settings/integrations/data-catalogs/overview/#supported-data-catalogs).

A link connects the container to one **table-level asset** in one connected catalog, and the same container can hold one link per catalog. This page covers where container links come from, how manual and automatic links behave, and why the datastore's link matters more than any single container's.

> **Info: This page covers containers**
>
> Everything here is about the links of a **container**. The datastore is the anchor of the feature; for how the links work on the other levels, see [How Data Catalog Links Work](https://userguide.qualytics.io/source-datastore/data-catalog-links/deep-dive/how-it-works/) and [How Field Data Catalog Links Work](https://userguide.qualytics.io/fields/data-catalog-links/deep-dive/how-it-works/).

## Availability

The dialog is offered on tables and views of datastores backed by a database connector (JDBC and native connectors). Computed containers (Computed Tables, Computed Files, and Computed Joins) cannot be linked. They exist only in Qualytics, so the catalog has no counterpart asset for them. File-based (DFS) datastores do not offer Data Catalog Links, and neither do enrichment datastores. A connected [data catalog integration](https://userguide.qualytics.io/settings/integrations/data-catalogs/overview/) is required.

## Manual Linking

The catalog synchronization creates links automatically by matching names and hierarchy between Qualytics and the catalog. When the automatic match picks the wrong table or finds none, anyone with the **Editor** team permission on the container's datastore can override it and point the container at its true counterpart.

The counterpart can be found two ways: by searching the catalog's tables by name or identifier, or by handing Qualytics the asset's URL from the catalog, from which it extracts the identifier and resolves the asset, each catalog with its own address format.

Relinking to a different asset resets the link's **Last Synced**, so the next synchronization pushes the full Qualytics metadata to the newly linked asset instead of skipping it as unchanged.

## Manual and Automatic Links

A link you set yourself is a **manual** link, and it behaves differently from the ones the synchronization creates:

- A manual link is never overwritten by a later synchronization. The automatic matcher leaves it alone.
- A manual link stays valid when the integration's configuration changes, while automatic links are re-evaluated.
- **Unlink** is only offered on manual links. Removing an automatic link would be pointless, since the next synchronization would just recreate it. After unlinking, the next synchronization is free to auto-match the container again.

## The Container Link Corrects This Container Only

Unlike a manual link on the datastore, which anchors how every container and field resolves in the catalog, a manual container link fixes that one asset and nothing else. If several containers resolve against the wrong catalog source, link the **datastore** manually instead of correcting containers one by one; see [How Data Catalog Links Work](https://userguide.qualytics.io/source-datastore/data-catalog-links/deep-dive/how-it-works/) at the datastore level.

## See Also

- **Synchronization**

  What a synchronization exchanges for container links, and why it runs at the datastore level.

  [Synchronization](https://userguide.qualytics.io/container/data-catalog-links/deep-dive/synchronization/)
- **Permissions**

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

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

*Last updated: September 7, 2026.*
