# Scheduling

Enable periodic runs in **Settings → Scheduling**.

### Standard scheduling

Use this for simple recurring syncs.

It applies one cadence to all enabled pairs.

The new Standard Scheduler replaces the old basic scheduler with a guided wizard.

Instead of showing every timing field at once, it works in two steps:

1. Choose a frequency.
2. Fill in the one extra timing field that matches that choice.

This keeps irrelevant inputs off the screen.

#### Current plan

The top of the wizard shows a live **Current plan** summary.

It updates as you change the schedule.

Use it to confirm the schedule in plain language before saving.

#### Frequency options

**Every hour**

Runs once at the top of every hour.

No extra timing field is needed.

**Every N hours**

Runs on a repeating hour-based interval.

Set how many hours to wait between runs.

Use this when hourly is too frequent, but once per day is too slow.

**Daily at**

Runs once per day at a specific local time.

Set a time like `03:30`.

**Custom**

Runs on a custom repeat interval in minutes or hours.

Use this when the built-in hourly or daily options do not fit.

#### Custom schedule rules

* Minimum interval: `15 minutes`
* Units: `minutes` or `hours`
* Intervals under `1 hour` show a warning in the UI

{% hint style="warning" %}
Intervals shorter than `1 hour` can look like aggressive polling to provider APIs.

That may be treated as API abuse and can risk throttling or a ban.
{% endhint %}

<figure><img src="https://565675962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3rh5THg1PdhVsBt3GALo%2Fuploads%2FnoM1zpe79AlI9WxWKDQd%2Fimage.png?alt=media&#x26;token=b88f9204-ec24-437d-8c11-7e8c0d83c4fa" alt=""><figcaption></figcaption></figure>

#### Recommendation

Start with **Daily at** for most setups.

Use **Every N hours** when you need a shorter repeat window.

### Advanced scheduling

Advanced Scheduling is the power-user mode.

Use it when one simple recurring timer is not enough.

Think of it like this:

* **Standard Scheduling**: one simple recurring sync plan
* **Advanced Scheduling**: multiple automations in one place

Use it when you need:

* per-pair timing
* timed step ordering
* automated captures
* event-based triggers

The advanced panel also includes a live **Current plan** summary.

It shows how many timed steps, capture schedules, and event triggers are configured.

It also tells you whether the plan is active, ready, or needs attention.

For the full setup, see [Advanced scheduling](https://wiki.crosswatch.app/crosswatch/scheduling/advanced-scheduling).

### Which mode to use

* Use **Standard Scheduling** for simple recurring syncs.
* Use **Advanced Scheduling** when you need multiple jobs, captures, event-driven behavior, or a more structured automation workflow.


---

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