health.md icon health.md
Core Feature · Set & Forget

Scheduling

Run exports automatically — daily or weekly, at a time you pick. Uses iOS background tasks plus a scheduled local notification as a fallback when the device is locked.

Schedule tab
Schedule tab

The Schedule tab

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

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

Schedule settings

Schedule settings
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

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.

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