> 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/main-dashboard/navigation/editor.md).

# Editor

Review data stored for your providers. Fix wrong matches, edit dates, ratings and progress, block items, and add or remove provider records.

For wrong matches, numbering differences, split or combined episodes, and saved rules, see [Mappings and episode groups](https://wiki.crosswatch.app/crosswatch/main-dashboard/navigation/editor/mappings-and-episode-groups.md).

## Get started

1. Open **Tools → Editor** from the main navigation.
2. Keep **Source** on **Current State**.
3. Choose a **List**, such as History or Watchlist.
4. Choose a provider account, or **All providers** for an overview.
5. Search for a title or narrow the results with the media type filters.
6. Use the row actions or select several rows for a bulk operation.

Available accounts and actions depend on your profile, permissions, and provider support.

## Simple and Advanced views

The Editor opens in Simple view. It includes the everyday tools: search, filters, Quick add, sending items, and mapping actions.

Click **Advanced** to show keys, external IDs, column controls, manual rows, the **Fixes for** scope selector, and maintenance tools. Click **Simple** to return. The Editor remembers your view preference.

You do not need Advanced to create a mapping. Use the mapping icon beside an item or the **Mapping** toolbar button to manage saved rules.

## Choose what to view

On smaller screens, expand **Source and filters** to choose the source, feature and provider instance.

### Current State

Current State combines stored provider records with your saved local changes. Opening or refreshing the Editor reloads this stored data; it does not fetch a new inventory from every provider.

Run a sync or use **Import provider state** when you need fresh provider data.

| List        | What it contains                                            |
| ----------- | ----------------------------------------------------------- |
| Watchlist   | Titles saved to watch later.                                |
| History     | Watched movies and episodes, with available watch dates.    |
| Ratings     | Your ratings.                                               |
| Progress    | Playback position, duration, percentage, and update time.   |
| Collections | Collection membership and collected dates, where supported. |

### All providers

**All providers** combines matching items into one row across the accounts available in the selected profile.

* Provider chips show which accounts contain an item.
* Dimmed provider icons offer a shortcut to send an item to a missing account.
* History displays the latest available watch date for each movie or episode.
* The mapping action lets you choose the account whose match you want to correct.

To edit values, open an individual provider account. From a merged row, the mapping account chooser opens that provider view; use the row mapping icon there to continue.

Admins can choose **Default accounts** or a user profile. Other users see the accounts they can access.

## Search and arrange the table

Search by title, series title, year, item key, or external ID. Episode searches also accept values such as S01, S01E02, 1x2, or season 1 episode 2.

Use the type chips to narrow the list. **Rows** controls the page size: 50, 100, 150, or 200. The header checkbox selects the visible page, so check the selected count before sending or removing data.

**Wide view** gives the table more space by hiding the side panel. In Advanced view, use **Columns** to choose and arrange fields. The **Pulse** panel summarizes the rows in the current view.

## Quick add

Use **Quick add** to find a title and write it directly to selected accounts.

1. Click **Quick add**.
2. Search under **Movies** or **Shows**, then choose a result.
3. Choose what to add: Watched, Watchlist, Rating, or a supported combination.
4. Choose the destination accounts. Use **other accounts** when needed.
5. For a watch, select the date. For a rating, choose a score from 1 to 10.
6. For a watched show, choose the whole show or pick episodes.
7. Review the selection and submit it.

Quick add writes to the providers. A later sync brings their updated records into the Editor.

## Edit dates, ratings, and progress

Select an individual provider account, then click the value in the final list column.

| List        | Editable values                                  |
| ----------- | ------------------------------------------------ |
| History     | Watched date and time.                           |
| Ratings     | Rating from 1 to 10.                             |
| Progress    | Position, duration, percentage, and update time. |
| Collections | Collected date and time.                         |

Dates and times use **UTC**. Progress can be entered as playback time or a percentage. When position and duration are both present, CrossWatch calculates the percentage.

These edits create local corrections. Click **Save changes** to keep them for future syncs. **Discard** drops pending edits and reloads the saved view.

Clearing a local value does not remove the provider record. Use **Remove from…** for that.

## Send or remove provider data

Use the send action beside a row, or select rows and open **Send to…**.

### Add to an account

Choose **Add to…**, select the destination accounts, and click **Send selected data**. Review the result for each account.

Only eligible accounts supporting the selected list are offered. Blocked or deleted rows are excluded from additions. Sending data does not create a permanent sync pair or save other pending Editor edits.

### Remove from an account

Choose **Remove from…** and wait for the matching accounts and record counts. Select the accounts, review the preview, then confirm the removal.

Removal needs an unambiguous match in an accessible sync pair's stored data. If no eligible targets appear, run the relevant sync first. Importing provider state alone does not create this pair evidence.

Removal changes the selected list, such as watched status, watchlist membership, or ratings. It does not delete media files. Another sync source can restore a removed record later; use a block as well when the item should stay excluded from sync.

For History, this workflow removes watched-state records, not a selected individual watch date. Providers handle repeat watches differently. For example, Floppy can remove one watch while other watches remain.

### Read the result

Check each destination's result. A successful write to one account does not mean all accounts succeeded. Skipped, unresolved, or failed records need attention before you assume the operation is complete.

## Where does this come from?

In **Current State**, select an individual provider account. Click the branching-arrow icon beside an item's title to inspect its likely source path.

The icon appears in Simple and Advanced views. It is unavailable in the merged **All providers** view and on **Playlist Endpoints**. Click it again to close the popover. The popover stays anchored to the item while you scroll.

**Destination** identifies the selected item and provider account. Provider tags show the provider logo, brand colour, and profile name. Anime IDs can also appear here.

**Comes from** lists matching source items, their provider and profile, and the sync pair name. Each source shows relevant IDs, its season or episode range, and the match method:

* Shared IDs
* Anime ID Mapping
* A custom anime mapping

For example, a path can be: **a source's TMDB show and season → your custom mapping → an AniList entry**.

The mapping method appears under **Comes from**, not again in the destination summary. Saved Editor corrections and manually added items are also identified when relevant.

When available, **Edit mapping** opens the correction workflow. **Custom anime mappings** opens the custom anime rules. Use [Mappings and episode groups](https://wiki.crosswatch.app/crosswatch/main-dashboard/navigation/editor/mappings-and-episode-groups.md) to correct a match.

{% hint style="warning" %}
This lookup reconstructs a likely path from current stored provider data, sync pairs, settings, and mappings. It is not a historical record or proof of which sync originally wrote the item. Changing mappings can change the explanation, and disabled pairs can appear.
{% endhint %}

No matching source does not prove CrossWatch never wrote the item. Older mappings, title-based matches, or items added directly on a provider can explain missing sources. If the mapping search reaches its limit, the popover warns that results may be incomplete.

Opening this lookup does not change provider data or start a sync.

## Mappings and blocks

Use the row mapping icon to correct an item's identity. Open **Mapping** in the toolbar to manage saved corrections, blocks, and episode groups.

A block excludes an item from future sync processing without removing it from its provider. Row and bulk block actions are saved with **Save changes**; actions inside **Mappings & blocks** save directly.

The [Mappings and episode groups](https://wiki.crosswatch.app/crosswatch/main-dashboard/navigation/editor/mappings-and-episode-groups.md) explains scopes, wrong matches, episode numbering, combined episodes, completed scrobbles, and import/export.

## Advanced maintenance

### View title statuses

Enable **Status** in the column chooser to show current title statuses for a selected provider instance. The column is hidden by default and read-only. Select one provider rather than **All providers**; season and episode rows show the parent show's status.

**Unknown** means the title did not have one unambiguous returned status. **Unavailable** means the read failed; refresh Editor to retry. A dash means no provider status is available in the selected context. Change synchronization rules through [Status mapping](https://wiki.crosswatch.app/crosswatch/settings/configure-pairs/provider-settings/status-mapping.md), not by editing this column.

### Rating choices

When adding or editing a rating, select the provider before choosing a score. CrossWatch offers the scores or reactions supported by that provider. Changing providers can clear an incompatible selection; choose a supported value before saving.

### Add a manual row

Use **Add row**, enter a unique item key, and fill in the media type, title, and reliable external IDs. For episodes, include the show identity and episode coordinates. Add any relevant date, rating, or progress value, then save.

A manual row becomes local source data for sync. Saving it does not create that record on the source provider account.

### Import provider state

Expand **Import provider state**, choose the provider account and supported lists, then select an import mode.

| Mode             | Result                                                 |
| ---------------- | ------------------------------------------------------ |
| Replace baseline | Refreshes the selected stored lists from the provider. |
| Merge (keep old) | Retains old rows and adds or updates returned records. |

Click **Import** and wait for completion. This reads provider data into CrossWatch. Saved local rules continue to apply.

### Policy backup

Use **Policy backup → Download JSON** to export local additions, corrections, blocks, and episode group rules. **Import file** merges a policy backup into the saved policy.

For transferring only mappings, blocks, and episode groups, use the separate export in **Mappings & blocks**. Neither file backs up your provider accounts or media files. A database backup also preserves episode group observations and completion tracking.

## Playlist Endpoints

Configure an endpoint on **Playlists**, then choose **Playlist Endpoint** as the Editor source.

Available actions depend on the endpoint. Editable playlists can support adding, removing, and reordering items. Smart and read-only endpoints cannot be edited.

Here, **Save changes** applies supported edits to the provider playlist. Sending endpoint rows through **Add to…** is a separate Watchlist operation.

## When does a change take effect?

| Action                              | Effect                                                            |
| ----------------------------------- | ----------------------------------------------------------------- |
| Quick add or Send                   | Writes directly to the selected providers.                        |
| Save changes in Current State       | Saves local changes for future syncs.                             |
| Save fix                            | Saves a mapping immediately for future syncs.                     |
| Use correction                      | Stages a mapping; finish with Save changes in Editor.             |
| Save group                          | Saves an episode group without starting a sync.                   |
| Save changes on a Playlist Endpoint | Applies supported provider playlist edits.                        |
| Import provider state               | Refreshes stored provider data in CrossWatch.                     |
| Where does this come from?          | Read-only lookup of the likely source path; does not change data. |

Saving a mapping or group does not rewrite existing provider history by itself. Run a sync, or refresh an open Interactive Sync review, to use the updated rules.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://wiki.crosswatch.app/crosswatch/main-dashboard/navigation/editor.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
