Troubleshooting Guide

Automation Issues

An enabled automation does not run

• Confirm that Background App Refresh is enabled for Health Auto Export and Low Power Mode is off.
• Keep your device unlocked while health data is read.
• Run the automation manually and check Activity Logs.

For a convenient manual trigger, add an Automations Widget. For a prompt to unlock and open the app, use Schedule Reminders.

Data arrives late

iOS decides when background execution is available. Sync Frequency is a desired cadence, not a guaranteed schedule. See Scheduling and background limits.

Files do not appear at the destination

Check the connected account, destination folder, network access, and available storage. Run a small manual export from the automation and inspect Activity Logs. Follow the destination’s guide for connection-specific checks.

Widget Issues

If a widget shows old status, unlock the device and tap the widget’s cloud button to run its automation. iOS controls refresh opportunities, so displayed status may lag. See Automations Widget troubleshooting.

Export Issues

Missing readings or medication data

Follow Data Missing in Export Files to check dates, sources, ordinary health permissions, and separate medication access.

An export stalls on an affected iOS version

See Source Information compatibility for the affected versions and setting. If the app shows a software-update error, follow that message before retrying.

REST API requests fail

Check the endpoint URL, POST support, authentication headers, and server logs. For oversized JSON requests, enable Batch Requests or reduce the export size.

A large export takes too long or fails

Use a shorter date range, fewer data types, or coarser time grouping. See Manual Export — Large exports.

Sync Issues

For data missing on Mac, confirm that both devices use the same iCloud account, iCloud Drive is enabled, and Sync to Mac is configured on your iPhone. Follow Sync to Mac troubleshooting to check available files and retry a selected range.

Getting Help

Open Settings → Chat Support on iPhone, iPad, or Mac. Choose Bug, Question, or Feature Request, enter your email address and description, and submit. You can attach screenshots or other files. Keep the reference number for follow-up. Replies arrive by email and may take time; check your spam folder too. On Apple Vision, Chat Support continues in Messages.

Describe what you expected, what happened, and the affected export or automation. For automation issues, include relevant Activity Logs screenshots. See App Event Logs if you need to export diagnostics separately.