# Getting Started with Data Catalog Links

Source: https://userguide.qualytics.io/source-datastore/data-catalog-links/getting-started/

Data Catalog Links connect your Qualytics assets (datastores, containers, and fields) to their counterpart assets in a connected data catalog, so quality metadata lands on the right asset and catalog metadata flows back. This section covers the links at the **source datastore** level:

- How the links work, and how manual and automatic links behave
- How to manage a datastore's link by hand
- How to synchronize a single datastore with its catalog
- The API behind the links, and answers to common questions

> **Tip: Containers and fields work slightly differently**
>
> Linking is not identical across levels. Each one searches its own kind of catalog asset and has its own availability rules. See [Data Catalog Links on Containers](https://userguide.qualytics.io/container/data-catalog-links/getting-started/) and [Data Catalog Links on Fields](https://userguide.qualytics.io/fields/data-catalog-links/getting-started/).

---

## Deep Dive

Understand what the links are, how manual and automatic linking behave, and who can do what.

- **Introduction**

  What Data Catalog Links are, where they apply, and which datastores offer them.

  [Introduction](https://userguide.qualytics.io/source-datastore/data-catalog-links/deep-dive/introduction/)
- **How It Works**

  Manual and automatic links, how a manual datastore link anchors its children, and what relinking changes.

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

  What Pull and Push exchange, and the two scopes a synchronization can run in.

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

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

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

---

## How-tos

Manage a datastore's links step by step.

- **Link Asset**

  Link a datastore to its counterpart asset, by search or by pasting the asset's URL.

  [Link Asset](https://userguide.qualytics.io/source-datastore/data-catalog-links/how-tos/link-asset/)
- **Change Asset**

  Point the link at a different catalog asset.

  [Change Asset](https://userguide.qualytics.io/source-datastore/data-catalog-links/how-tos/change-asset/)
- **Unlink Asset**

  Remove a manual link and hand the match back to the automatic synchronization.

  [Unlink Asset](https://userguide.qualytics.io/source-datastore/data-catalog-links/how-tos/unlink-asset/)
- **Link Another Catalog**

  Link the same datastore in one more connected catalog.

  [Link Another Catalog](https://userguide.qualytics.io/source-datastore/data-catalog-links/how-tos/link-another-catalog/)
- **Sync a Catalog**

  Start a synchronization scoped to the datastore, straight from the dialog.

  [Sync a Catalog](https://userguide.qualytics.io/source-datastore/data-catalog-links/how-tos/sync-catalog/)

---

## API & FAQ

- **API**

  Read, set, and clear catalog links programmatically, search catalog assets, and start scoped syncs.

  [API](https://userguide.qualytics.io/source-datastore/data-catalog-links/api/)
- **FAQ**

  Common questions about availability, manual links, unlinking, and synchronization.

  [FAQ](https://userguide.qualytics.io/source-datastore/data-catalog-links/faq/)

*Last updated: September 7, 2026.*
