# 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="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/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/configure-pairs/features.md).

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

### Details by topic

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

### When a section is disabled

Dependent controls lock.

This prevents accidental changes.

### Related topics

* [Syncing](/getting-started/first-time-setup/what-do-you-need/syncing.md)
* [Best practices](/getting-started/best-practices.md)


---

# Agent Instructions: 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:

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

The question should be specific, self-contained, and written in natural language.
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.