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