# Navigation

Use the UI to connect providers, configure pairs, and run syncs.

Most setup problems come from [**Authentication**](/crosswatch/providers/authentication.md), [**Pairs**](/crosswatch/configure-pairs.md), or [**Metadata**](/crosswatch/providers/metadata.md).

### Main navigation

* **Main**

  * Start runs
  * Watch progress and logs
  * Use **Refresh** to re-check provider status

  <figure><img src="/files/x9CsqyyS2kBJUWxNmang" alt=""><figcaption></figcaption></figure>
* **Quick Add**
  * Manually send **History**, **Watchlist**, or **Rating** actions to providers
  * Docs: [Quick Add](/crosswatch/navigation/quick-add.md)
* **Watchlist**
  * Preview watchlist items
  * Requires a metadata provider and [Watchlist](/crosswatch/configure-pairs/features/watchlist.md) syncing enabled
* **Captures**
  * Rollback provider watchlist/ratings/history (not a full backup)
  * Docs: [Captures](/crosswatch/tools/captures.md)
* **Editor**
  * Inspect and edit local CrossWatch data (CW Tracker / Current State)
  * Docs: [Editor](/crosswatch/tools/editor.md)
* **Settings** (dropdown)
  * Settings overview
  * Providers (auth, sync, metadata)
  * Sync pairs
  * Scheduling
  * Scrobbler
  * UI settings
* **About**
  * About: Version, links, and Help

### Where to configure things

Most configuration lives under **Settings**.

Use these pages when you want the detail for one area:

* [Settings](/crosswatch/navigation/settings.md) — what each settings area controls
* [Quick Add](/crosswatch/navigation/quick-add.md) — manually send history, ratings, or watchlist actions
* [Plex SSO](/crosswatch/navigation/ui-settings/security/plex-sso.md) — optional Plex sign-in for the web app
* [Authentication](/crosswatch/providers/authentication.md) — connect providers (under **Settings → Providers**)
* [Configure Pairs](/crosswatch/configure-pairs.md) — pair options and safety controls
* [Scheduling](/crosswatch/scheduling.md) — periodic runs
* [Scrobble](/crosswatch/scrobble.md) — real-time playback syncing
* [Maintenance](/crosswatch/maintenance.md) — debug level and cleanup tools
* [HTTPS/TLS](/crosswatch/navigation/ui-settings/user-interface/https-tls.md) — UI TLS and certificates

### Common workflows

#### Connect providers

1. Open **Settings → Providers**
2. Connect what you need
3. Click **Save**

Providers show up in **Sync pairs** only after they connect.

#### Create a pair

1. Open **Settings → Sync pairs**
2. Create one pair first
3. Start **one-way** with **one feature**

Related: [Syncing](/getting-started/first-time-setup/what-do-you-need/syncing.md).

#### Run and validate

1. Go to **Main**
2. Run a sync
3. Fix mismatches in [**Analyzer**](/crosswatch/tools/analyzer.md) or [**Editor**](/crosswatch/tools/editor.md)
4. Run again

Related: [Tools](/crosswatch/tools.md).

### Saving and applying changes

* Use **Save** to persist changes
* If a run is active, changes apply on the next run
* Some settings require a restart (example: switching HTTP ↔ HTTPS)


---

# 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/navigation.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.