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 Custom. Custom schedules repeat every N days, weeks, or months from a chosen start date. The lookback controls how many completed days each run covers.

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 date range with the currently configured settings and destination, then records a new history row.

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 is not 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.

Profile schedules and cancellation

• Every profile can keep its own schedule, including a custom cadence. Switching the active profile does not retarget another profile’s schedule.
• A collision warning appears when profiles could write the same rendered paths at the same destination. Review it before enabling competing schedules. Health.md does not silently change either profile.
• Stop or Cancel ends only the current attempt. Completed dates stay completed, unresolved dates remain retryable, and the schedule stays enabled.
• Each history row remains pinned to the run-time profile and the privacy-safe destination label actually used.

Manage the frozen settings and per-profile destination in Export profiles.

Related

Multiple workflowsExport Profiles, give each saved setup its own destination and cadence. ManualExport, for one-off date ranges. AutomateShortcuts, toggle the schedule from automations. Cross-deviceMac Sync, schedule on Mac too.