Scheduling

The Schedule tab

A status screen, not a settings panel. It tells you in one glance:

• Whether the schedule is on or off
• The next scheduled run, if any
• The last run's outcome

One button — Set Up Schedule (or Manage Schedule) — opens the detail view.

Schedule settings

Enable Scheduled Exports

Master toggle at the top. When off, no background runs and no notifications.

Frequency

Daily, Weekly, or Monthly. Daily exports cover yesterday; weekly covers the previous 7 days; monthly covers the previous 30.

Time

Hour and minute. iOS treats this as a hint, not a guarantee — see the limitations callout below.

Export history

The list at the bottom of the Schedule screen records every scheduled run with its outcome. Tap a row to see details. Failed runs include a Retry button that re-runs that specific date range.

How iOS scheduling actually works

1. Target timeHealth.md asks iOS to wake the app around your chosen time. 2. Background attemptIf the device is available, iOS runs a background refresh task. 3. Locked fallbackIf HealthKit is unavailable, Health.md posts a notification. 4. Tap to finishOpening the notification lets the app read HealthKit and export.

iOS limitations you should know.

HealthKit data isn't readable while the device is locked. Scheduled exports run via BGAppRefreshTask, which iOS opportunistically schedules based on usage patterns — your time setting is a target, not a contract. As a fallback, the app posts a local notification at the scheduled time if the device is locked; tap it to run the export.

• The scheduled time is approximate. iOS may run the task earlier, later, or skip it if the device is dead/disconnected.
• Scheduled exports work best when your phone is regularly plugged in and unlocked at roughly the same time each day.
• If the export fails because the device was locked, tap the notification — that runs the export with HealthKit access.

Programmatic control

You can turn the schedule on/off from Shortcuts using the Turn Scheduled Export On or Off intent. See Shortcuts for examples.

Related

ManualExport — for one-off date ranges. AutomateShortcuts — toggle the schedule from automations. Cross-deviceMac Sync — schedule on Mac too.