> 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/navigation/quick-add.md).

# Quick Add

Quick Add lets you manually send actions for a movie or show.

Use it when playback happened outside your normal media server flow.

{% hint style="info" %}
Quick Add is available in **v0.9.18 and later**.
{% endhint %}

Examples:

* a cinema visit
* travel or offline viewing
* a missed scrobble
* a title watched on another device

Instead of updating each provider one by one or using sync pairs. Quick Add sends one request to multiple configured providers.

### What Quick Add can send

Quick Add supports these actions:

* **History**
* **Watchlist**
* **Rating**

You can send:

* one action only
* or any combination of those actions

{% hint style="info" %}
Quick Add opens the manual watched flow.
{% endhint %}

### How to open Quick Add

Quick Add is available from the CrossWatch UI.

Depending on your device:

* **Desktop** uses the Quick Add side launcher
* **Mobile** uses the floating Quick Add button

Selecting **Quick Add** opens the manual watched dialog.

### Step-by-step

{% stepper %}
{% step %}

### 1) Search for the title

Choose **Movies** or **Shows**.

Type the title into the TMDb search box.

Pick the correct result.

After selection, the item appears under **Selected Item**.

On mobile, the search area can collapse after selection.
{% endstep %}

{% step %}

### 2) Choose the action

In **Actions**, select one or more:

* **History**
* **Watchlist**
* **Rating**

These actions are independent.

You can send history only, rating only, watchlist only, or any mix.

#### Action behavior

**History**

* marks the item as watched on supported providers

**Watchlist**

* adds the item to watchlists on supported providers

**Rating**

* sends the chosen score to providers that support ratings
  {% endstep %}

{% step %}

### 3) Set the watched date

If **History** is enabled, choose **When Watched**:

* **Today**
* **Release date**
* **Choose date**

**Today** uses the current date and time.

**Release date** uses the TMDb release date or first air date.

**Choose date** lets you pick a custom date.

If **History** is off, this section stays disabled.
{% endstep %}

{% step %}

### 4) Set a rating

If **Rating** is enabled, choose a value with the rating control.

{% hint style="warning" %}
If **Rating** is enabled, you must select a valid score before sending.
{% endhint %}

If **Rating** is off, the rating control is ignored.
{% endstep %}

{% step %}

### 5) Select providers

In **Send To**, select the configured providers that should receive the action.

Provider behavior:

* only configured providers are shown
* multi-instance providers are supported
* capability badges can show **History**, **Watchlist**, and **Rating** support
* media servers can appear in a separate group when relevant

#### Selection defaults

By default, no providers are selected.

If you used Quick Add before, CrossWatch restores your last provider selection when possible.

You can also use:

* **Use last**
* **Select all**
* **Clear**
  {% endstep %}

{% step %}

### 6) Send the action

Before sending, make sure you selected:

* a title
* at least one action
* at least one provider
* a rating value, if **Rating** is enabled

Then click **Send to providers**.

CrossWatch sends the selected action or actions to the selected providers.
{% endstep %}
{% endstepper %}

### Mobile behavior

On mobile:

* the dialog uses a single-column layout
* some sections can collapse to reduce scrolling
* **Send To** starts collapsed by default
* Quick Add is available as a floating action button

### Tips

* If a provider does not support one selected action, that action is skipped for that provider.
* Reusing the remembered provider selection saves time.
* Use **Choose date** for older manual entries.
* Use **Release date** carefully. It reflects TMDb metadata, not when you personally watched it.

### Limitations

* Quick Add depends on TMDb search and metadata matching.
* Provider support differs for history, watchlist, and ratings.
* A provider can support one action and not another.
* If **Rating** is enabled, you must select a valid score.


---

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