> For the complete documentation index, see [llms.txt](https://wiki.crosswatch.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.crosswatch.app/crosswatch/settings/configure-pairs.md).

# Configure Pairs

Pairs define what syncs, in which direction, and with what safety rules.

* Left = **Source**
* Right = **Target**

Enable only what you need. Source always wins conflicts.

{% hint style="info" %}
First run: **one-way** and **one feature**
{% endhint %}

{% hint style="success" %}
Most safe first pairs are media server → tracker.
{% endhint %}

{% hint style="info" %}
Defaults are good for most users.

Most setups only require:

* Pick Source and Target
* Pick the right **profiles**
* Enable **Watchlist**, **Ratings**, **History**, and/or **Progress**
  {% endhint %}

### Header (the basics)

* **Enabled**: master switch for the pair.
* **Source / Target**: provider pickers.
* **Source profile / Target profile**: pick which profile to use.
  * Defaults to `default`.
  * See [Profiles](/crosswatch/settings/connections/profiles.md).
* **Mode**:
  * **One-way**: target follows source.
  * **Two-way**: both sides contribute.

{% hint style="warning" %}
Choose **Two-way** only when you already trust matching on both sides.

For most setups, **One-way** is safer.
{% endhint %}

<figure><img src="/files/5fwDpevnxe6Szkk0EDUi" alt=""><figcaption></figcaption></figure>

### Feature tabs

Feature tabs show up only when **both** providers support that feature.

Start here for feature-specific options: [Features](/crosswatch/settings/configure-pairs/features.md).

Pairs that contain **AniList** can show extra options on **Watchlist** and **Ratings**.

That includes **Use Anime ID Mapping** and, when AniList can receive writes, **Anime-only sync**.

See [AniList pair options](/crosswatch/settings/configure-pairs/anilist-pair-options.md).

* [Watchlist](/crosswatch/settings/configure-pairs/features/watchlist.md)
* [Ratings](/crosswatch/settings/configure-pairs/features/ratings.md)
* [History](/crosswatch/settings/configure-pairs/features/history.md)
* [Progress](/crosswatch/settings/configure-pairs/features/progress.md)

### Details by topic

* Safety switches and guardrails: [Global settings](/crosswatch/settings/configure-pairs/global-settings.md)
* Pair-scoped provider behavior: [Provider settings](/crosswatch/settings/configure-pairs/provider-settings.md)
* Pair-only library scoping: [Pair-level Whitelisting](/crosswatch/settings/configure-pairs/provider-settings/pair-level-whitelisting.md)
* AniList-specific pair controls: [AniList pair options](/crosswatch/settings/configure-pairs/anilist-pair-options.md)
* Watchlist controls and Jellyfin/Emby mode: [Watchlist](/crosswatch/settings/configure-pairs/features/watchlist.md)
* Ratings scope and backfill window: [Ratings](/crosswatch/settings/configure-pairs/features/ratings.md)
* History behavior and safety limitations: [History](/crosswatch/settings/configure-pairs/features/history.md)
* Resume position syncing (compatible provider pairs): [Progress](/crosswatch/settings/configure-pairs/features/progress.md)

### When a section is disabled

Dependent controls lock.

This prevents accidental changes.

### Related topics

* [Pair synchronization](/getting-started/support-matrix/pair-synchronization.md)
* [Best practices](/getting-started/best-practices.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://wiki.crosswatch.app/crosswatch/settings/configure-pairs.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.