Configure Pairs
How to configure a sync pair, feature toggles, and safety controls.
This modal defines what a pair does.
Left = Source
Right = Target
Enable only what you need.
First run: one-way + one feature + dry run.
Default settings are good for most users. You usually do not need to change Global settings or Provider settings.
Most setups only require:
Pick Source and Target
Enable the feature you want: Watchlist, Ratings, and/or History
Header
Enabled: master switch for the pair.
Source / Target: provider pickers.
Mode:
One-way: target follows source.
Two-way: both sides contribute.
Tabs
Feature tabs show up only when both providers support that feature.
Global settings
These apply to the whole pair.
Dry run: plan only. No writes.
Verify after write: re-check a small sample after writes.
Drop guard: blocks destructive plans when the source snapshot is empty.
Allow mass delete: allows bulk removals when needed.
Tombstone retention (days): keeps delete markers to avoid re-adding items.
Include observed deletes: treats provider-side deletions as intentional.
Allow Mass Delete is enabled by default because it’s often needed for the very first sync. Once your pairs are stable, you can disable it for extra safety, or use Drop Guard instead. You cannot enable both Mass Delete AND Drop guard at the same time.
Blackbox (advanced)
Blackbox is a staging area for uncertain changes.
Use it when:
IDs are unstable.
Providers “flap” (adds keep reappearing).
You want a cooldown before applying removals.
Settings:
Enabled
Pair-scoped
Promote after (days)
Unresolved days
Cooldown (days)
Watchlist
Enable: toggles watchlist syncing.
Add: add missing items to target.
Remove: remove items missing on source.
Jellyfin/Emby watchlist mode
Jellyfin/Emby don’t have a native “watchlist”. CrossWatch emulates it via:
Favorites (recommended)
Playlist
Collection
Prefer Favorites or Collection. Avoid Playlist unless you need it.
Ratings
Enable
Add / Update
Remove (clear)
Scope:
All
or only Movies, Shows, Episodes
History window:
All: backfill everything
From a date: backfill only recent ratings
On some providers, rating a movie can affect completion state. Use a narrow date window for large backfills.
History
Enable
Add
Remove: intentionally disabled for safety
History removes are disabled to prevent accidental data loss.
When a section is disabled
Dependent controls lock to prevent accidental changes.
Related topics
Last updated