---
title: "Scheduled tasks"
url: https://docs.corefinity.com/guides/sites/site-settings/scheduled-tasks
type: guide
last_updated: 2026-11-13
feature: crons
related:
  - https://docs.corefinity.com/api/reference/site-settings/get-site-crons.md
  - https://docs.corefinity.com/api/reference/site-settings/replace-site-crons.md
  - https://docs.corefinity.com/api/reference/site-settings/check-site-cron.md
  - https://docs.corefinity.com/mcp/tools/corestack_crons_get.md
  - https://docs.corefinity.com/mcp/tools/corestack_crons_validate.md
  - https://docs.corefinity.com/mcp/tools/corestack_crons_update.md
---
# Scheduled tasks

Run a command on your site on a schedule, and check that it ran.

## Before you start

- You can open the site in **Managed Websites**. Anyone who can open a site can change its scheduled tasks.
- You know the command to run. It runs as `web` from the site's `htdocs` folder.

## Add a task

1. **Open the site's scheduled tasks**

   Go to **Managed Websites**, choose the site, then **Scheduled tasks** under **Site settings**.

   _Screenshot: A site page with the Scheduled tasks card open. It lists the built-in Magento cron and three tasks, each with its schedule, command and last run._

2. **Name it, then set the schedule and command**

   Choose **Add task** and enter a **Task name**. Pick a **Schedule**, then enter the **Command**.

   _Screenshot: The Add task dialog: the name Nightly stock import, the schedule Daily at 03:00 with its next three runs, the command, a time limit of 1 hour and two ticked options._

3. **Add it and save**

   Choose **Add task**, then **Save changes**. Nothing on the site changes until you save.

   _Screenshot: The Scheduled tasks card with the new task marked New at the bottom of the list, the line 1 unsaved change, and Save changes ringed beside Discard._

The task is on the site within a minute or two. Its next run is under **Last run**.

### Choices in the dialog

| Choice                                      | What it does                                                                                                  |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| **Preset**                                  | Offers the common schedules, from **Every minute** to **Monthly on day**.                                     |
| **Custom**                                  | Takes a cron expression, such as `15 2 * * *`.                                                                |
| **Time limit**                              | Stops a run that is still going after **15 minutes**, **1 hour** or **6 hours**, and records it as timed out. |
| **Skip if the previous run is still going** | Stops two runs of the task overlapping.                                                                       |
| **Enabled**                                 | Untick to keep the task without running it.                                                                   |

Times are London time.

## Check a task ran

1. **Read the Last run column**

   **Last run** shows when each task last ran, whether it succeeded and how long it took.

   _Screenshot: The Scheduled tasks list with the columns On, Task, Schedule, Command and Last run. The first row, Magento cron, is built in and has a padlock in place of a menu._

   _Screenshot: The Scheduled tasks list of a Laravel site. Under Last run, Send booking reminders reads Exit 1 in red and the other tasks read OK, each with how long the run took and when the next one is due._

The first row is built in: it runs the platform's own cron, such as **Magento cron** or **WordPress cron**. It cannot be edited or removed.

## Change, pause or remove a task

1. **Use the task's row**

   Use the switch under **On** to pause a task or start it again. Open its **…** menu for **Edit…**, **Duplicate** and **Remove**.

   _Screenshot: The Scheduled tasks list with one task's menu open, showing Edit…, Duplicate and Remove._

2. **Save**

   Choose **Save changes**.

The switch **Scheduled tasks: On**, at the top of the card, pauses every task at once.

## Automate this

**API:** [Replace a site's scheduled tasks](https://docs.corefinity.com/api/reference/site-settings/replace-site-crons.md), scope `write`

```bash
curl -X PUT https://manage.corefinity.com/api/corestack/sites/1042/crons \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "entries": [
      {
        "command": "curl -s -o /dev/null https://www.harbourandfinch.example.com/",
        "enabled": true,
        "label": "Warm the cache",
        "no_overlap": true,
        "schedule": "*/15 * * * *",
        "timeout": 900
      }
    ],
    "version": 0
  }'
```

**MCP:** [`corestack_crons_update`](https://docs.corefinity.com/mcp/tools/corestack_crons_update.md), scope `write`

```json
{
  "name": "corestack_crons_update",
  "arguments": {
    "site_id": 4211,
    "version": 3,
    "enabled": true,
    "entries": [
      {
        "label": "Deploy key",
        "schedule": "*/15 * * * *",
        "command": "php -v",
        "enabled": true,
        "no_overlap": false,
        "timeout": 900
      }
    ]
  }
}
```

**Control Panel:** Managed Websites › your site › Site settings › Scheduled tasks ([https://manage.corefinity.com/go/crons](https://manage.corefinity.com/go/crons))

## Related

- [Logs](/guides/sites/logs-and-monitoring/logs): Read and narrow a site's logs.
- [Platform tools](/guides/sites/create-and-manage/platform-tools): Run your platform's maintenance commands.
- [Backups](/guides/sites/backups/snapshots): Take a backup before a change.
