> 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/tools/import-export.md).

# Import / Export

## Import / Export

The Import / Export tool lets you move your media data into or out of CW.

Use **Import** to bring existing watch history, ratings and watchlists from other trackers into the CW Tracker. Use **Export** to convert data available in CW into formats that can be used by other services.

### Import

The Import tab allows you to import existing tracker exports directly into CW.

Supported sources include:

1. Trakt
2. Letterboxd
3. Simkl
4. IMDb
5. TV Time
6. Yamtrack
7. Generic CSV or JSON files

CrossWatch can also automatically detect supported export formats.

Before importing, make sure the **CW Tracker** is configured under Connections. Imported data is written to the selected CW Tracker profile.

#### Importing data

1. Open **Tools**, then **Import / Export**.
2. Select the **Import** tab.
3. Select the source, or leave it on **Auto detect**.
4. Select the target CrossWatch Tracker profile.
5. Choose the export file.
6. Select which data you want to include.
7. Click **Preview file**.

Nothing is imported during the preview.

CW analyses the file and shows the detected items before anything is written to your tracker.

You can import:

**History**, watched movies, shows, seasons and episodes

**Ratings**, ratings contained in the source export

**Watchlist**, items saved to your watchlist

The preview can be filtered by media type, feature, title, year, ID and import status.

#### Preview status

Each item receives a status before import.

**Ready**, the item can be imported

**In tracker**, the item already exists in the target profile

**Duplicate**, the same item occurs more than once in the uploaded file

**Missing IDs**, CW could not find enough information to identify the item

**Invalid**, required information such as a watched date or rating is missing

**Unsupported**, the item or feature cannot currently be imported

By default, CrossWatch imports items marked as Ready.

Enable **Include existing** if you also want to process items that are already present in the CW Tracker. This can be useful when restoring or merging data.

You can import all ready items or manually select individual rows from the preview.

When you are satisfied with the preview, click **Import**.

### Export

The Export tab lets you export data available in CW to formats understood by other media services.

Select the source provider and, when applicable, the provider instance. You can then choose which data you want to export.

Available features include:

**Watchlist**

**History**

**Ratings**

**History & Ratings**

You can further filter the export by media type or search for specific titles, years or IDs.

Click **Preview** to inspect the matching items before creating the export.

By default, **All filtered** exports every item matching the current filters. Disable it if you only want to export selected rows.

Select the required export format and click **Export** to create the file.

Some formats only support specific features or media types. CW automatically adjusts the available options based on the selected export format.


---

# 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/main-dashboard/tools/import-export.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.