---
title: Schedule
---

import { Callout } from 'fumadocs-ui/components/callout'
import { Tab, Tabs } from 'fumadocs-ui/components/tabs'
import { Image } from '@/components/ui/image'
import { FAQ } from '@/components/ui/faq'

The Schedule block automatically triggers workflows on a recurring schedule at specified intervals or times.

<div className="flex justify-center">
  <Image
    src="/static/blocks/schedule.png"
    alt="Schedule Block"
    width={500}
    height={400}
    className="my-6"
  />
</div>

## Schedule Options

Configure when your workflow runs:

<Tabs items={['Simple Intervals', 'Cron Expressions']}>
  <Tab>
    <ul className="list-disc space-y-1 pl-6">
      <li><strong>Every X Minutes</strong>: Run at minute intervals (1-1440)</li>
      <li><strong>Hourly</strong>: Run at a specific minute each hour</li>
      <li><strong>Daily</strong>: Run at a specific time each day</li>
      <li><strong>Weekly</strong>: Run on a specific day and time each week</li>
      <li><strong>Monthly</strong>: Run on a specific day and time each month</li>
    </ul>
  </Tab>
  <Tab>
    <p>Use cron expressions for advanced scheduling:</p>
    <div className="text-sm space-y-1">
      <div><code>0 9 * * 1-5</code> - Every weekday at 9 AM</div>
      <div><code>*/15 * * * *</code> - Every 15 minutes</div>
      <div><code>0 0 1 * *</code> - First day of each month</div>
    </div>
  </Tab>
</Tabs>

## Activation

Schedules are tied to workflow deployment:

- **Deploy workflow** → Schedule becomes active and starts running
- **Undeploy workflow** → Schedule is removed
- **Redeploy workflow** → Schedule is recreated with current configuration

<Callout>
You must deploy your workflow for the schedule to start running. Configure the schedule block, then deploy from the toolbar.
</Callout>

## Automatic Disabling

Schedules automatically disable after **100 consecutive failures** to prevent runaway errors. When disabled:

- A warning badge appears on the schedule block
- The schedule stops executing
- Click the badge to reactivate the schedule

<div className="flex justify-center">
  <Image
    src="/static/blocks/schedule-3.png"
    alt="Disabled Schedule"
    width={500}
    height={400}
    className="my-6"
  />
</div>

<Callout>
Schedule blocks cannot receive incoming connections and serve as workflow entry points only.
</Callout>

<FAQ items={[
  { question: "Do I need to deploy my workflow for the schedule to start?", answer: "Yes. Schedules are created in the database only when you deploy the workflow. Undeploying removes the schedule, and redeploying recreates it with the current configuration." },
  { question: "What exactly happens after 100 consecutive failures?", answer: "After 100 consecutive failures, the schedule is automatically set to a disabled status to prevent runaway errors. A warning badge appears on the schedule block in the editor. You can click the badge to reactivate it. The failure counter resets to zero on any successful run." },
  { question: "Does the schedule support timezones?", answer: "Yes. The schedule configuration includes a timezone setting. Cron expressions and simple intervals are evaluated relative to the configured timezone, which defaults to UTC if not specified." },
  { question: "What happens if my scheduled workflow is rate-limited?", answer: "If a rate limit (HTTP 429) is encountered during a run, the schedule automatically retries after a 5-minute delay rather than counting it as a failure." },
  { question: "Can I have multiple schedule blocks in one workflow?", answer: "Yes. The deployment process finds all schedule blocks in the workflow and creates a separate schedule record for each one. Each schedule operates independently with its own cron expression and failure counter." },
  { question: "What happens if the workflow is undeployed while a scheduled run is in progress?", answer: "The currently running workflow will complete, but no new runs will be triggered. When the schedule next tries to fire, it checks that the workflow is still deployed and the schedule record still exists before running." },
]} />

