The uptime:schedule tag

The uptime:schedule tag tells Uptime Scheduler when a resource should be running. Add the tag to any supported AWS resource and the scheduler will start it at the beginning of the window and stop it at the end.

Tag key

uptime:schedule

Schedule format

[time-range] [days]

The time range must come before the day specification. Both parts are required unless using a named preset.

Time range formats

Format	Example	Meaning
`H-H`	`9-17`	9:00 AM to 5:00 PM (hour precision)
`HHMM-HHMM`	`0830-1730`	8:30 AM to 5:30 PM (minute precision)

Hours use 24-hour format. 0 is midnight, 23 is 11 PM.

Day specifications

Value	Meaning
`mon-fri`	Monday to Friday
`weekdays`	Monday to Friday (alias)
`sat-sun`	Saturday and Sunday
`weekends`	Saturday and Sunday (alias)
`mon-sun`	Every day
`daily`	Every day (alias)
`mon`, `tue`, `wed`, `thu`, `fri`, `sat`, `sun`	Specific days

Named presets

Value	Meaning
`weekdays-business-hours`	Monday–Friday, 9:00 AM–5:00 PM
`always-on`	Resource is always running (scheduler takes no action)
`always-off`	Resource is always stopped

Examples

# Weekday business hours
uptime:schedule = 9-17 mon-fri

# Extended hours with minutes
uptime:schedule = 0800-1900 mon-fri

# Weekend only
uptime:schedule = 10-16 weekends

# Every day
uptime:schedule = 6-22 daily

# Named preset
uptime:schedule = weekdays-business-hours

Timezone

All times are in the timezone configured for your AWS account during CloudFormation deployment. You can view the configured timezone in the dashboard.

Daylight saving time is handled automatically — the scheduler always fires at the wall clock time you specified, regardless of DST transitions.

How to apply the tag

AWS Console

Navigate to the resource in the AWS Console
Open the Tags tab
Add a tag with key uptime:schedule and your schedule as the value

AWS CLI

# EC2
aws ec2 create-tags \
  --resources i-0123456789abcdef0 \
  --tags Key=uptime:schedule,Value="9-17 mon-fri"

# RDS
aws rds add-tags-to-resource \
  --resource-name arn:aws:rds:eu-west-2:123456789012:db:my-db \
  --tags Key=uptime:schedule,Value="9-17 mon-fri"

Terraform

resource "aws_instance" "app" {
  # ...
  tags = {
    "uptime:schedule" = "9-17 mon-fri"
  }
}

AWS CDK

instance.applyRemovalPolicy(RemovalPolicy.RETAIN);
Tags.of(instance).add('uptime:schedule', '9-17 mon-fri');

Removing a schedule

Remove the uptime:schedule tag from the resource. The EventBridge rules will be deleted and the resource will no longer be managed by Uptime Scheduler. The resource is left in its current state.