Sync Apple Health Data

to Mac, Vision Pro & iPad

Enable Auto Sync on iPhone

Important: Add the “Auto Sync” widget for Health Auto Export to your Home Screen in order to sync data without opening the app. Please follow the instructions below.

Using Health Auto Export on Mac (version 3.0 and later) and Vision Pro:

  • On iPhone, navigate to the Automations tab.

  • To sync Health Metrics, select Auto Sync Health Metrics. 

  • Turn on syncing. To sync Workouts, select Auto Sync Workouts. Turn on syncing.

  • Add the Auto Sync widget to your Home Screen.

  • Data is synced to iCloud Drive when you open Health Auto Export in the foreground, and when the app runs in the background while your iPhone is unlocked. Your most recent data will appear first, and historical data will populate over time.

  • Read about how syncing works here.

Legacy Support (version 2.1.4 and earlier on Mac):

  • On iPhone, navigate to the Automations tab.

  • To sync Health Metrics, select Auto Sync Health Metrics. Turn on syncing. 

  • To sync Workouts, select Auto Sync Workouts. Turn on syncing.

  • Add the Auto Sync widget to your Home Screen

  • Data is synced to iCloud using CloudKit when you open Health Auto Export in the foreground, and when the app runs in the background while your iPhone is unlocked.

  • Please note that due to iOS and iCloud transfer limitations, all data will not sync immediately. Your most recent data will appear first, and historical data will populate over time.

  • Data can also be synced manually. You must keep Health Auto Export running in the foreground while performing manual syncing

    • Manual Syncing: Use the date pickers to select a date range to upload data for a specific period. This can be useful if data is missing for a specific period of time.

    • Activity Logs contain details to help keep track of how often automatic occurs, or when manual syncing is triggered, and if any errors were encountered. Logs help with determining if there are issues with Apple Health permission or iCloud configuration errors. Logs are also useful in bug reporting. If you experience issues syncing data across devices and file a bug report, be sure to include details about logs by sharing a screenshot.


Auto Sync requires the Premium access in-app purchase after the trial period has ended.

Apple Health on iPad

With the introduction of Apple Health in iPadOS 17, Health Auto Export integrates directly with the Health app. This means syncing to iPad via Health Auto Export is only required for Mac, Vision Pro and iPads running iPadOS 16 or lower.

Enable Legacy Support in order to view Apple Health data on iPads running iPadOS 16 and below.

How to Use the Auto Sync Widget

Add the Auto Sync widget to your Home Screen in order to run sync data while Health Auto Export is in the background.

  • Follow Apple’s instructions for adding widgets to the Home Screen. In the widget menu, search for “Auto Export.”

  • Swipe to the “Auto Sync” widget type. Tap on the widget to add it to your Home Screen.

  • When the widget updates, new data is synced to your Mac.

 

Mac & Vision Pro

Data synced from iPhone will automatically appear on other devices. See How Syncing Works

  • The data available to be viewed in the Mac and Vision Pro apps can be exported as JSON, CSV and GPX files.

  • Legacy App Only:

    • Activity Logs are available on the Auto Sync screen (selectable in the sidebar), and will show how often data is being fetched from iCloud and any errors encountered. If you are experiencing issues with syncing, refer to the Activity Logs to determine if there are any errors being encountered. When filing a bug report, be sure to include details of any errors or a screenshot.

How Syncing Works

Auto Sync uses iCloud to transfer data between devices. Syncing does not work over USB.

  • When using Health Auto Export v3.0 and later for Mac or on Vision Pro, data is transferred via iCloud Drive. The transferred data is visible in iCloud Drive > Auto Export> Auto Sync.

    • Data should download to your Mac or Vision Pro automatically.

    • If you have enabled optimized storage on your iCloud Drive, in some cases, you may need to force-download files and folders to your device.

    • Navigate to the Auto Sync folder as described above, then select the folder and click on “Download Now.”

    • Learn more about optimized storage here.

  • When using Legacy support is enabled, data is synced via CloudKit to your Mac. The data transferred is not visible in your file system.

  • You must be signed into the same iCloud account on your Mac/Vision Pro as on iPhone.

  • After initial setup, it will take some time before your data history appears on other devices. Data is synced in reverse chronological order, i.e. new data will sync first and older data syncs last.

Troubleshooting

If data is not syncing between devices, check the following criteria to ensure you are set up correctly.

  • You must be signed into the same iCloud account on your devices.

  • iCloud and iCloud Drive must be enabled on all devices for Health Auto Export in iCloud settings section of the Settings app.

  • On iPhone, ensure you have granted read access to Apple Health.

  • On iPhone, ensure you have Auto Sync enabled for health metrics and workouts.

  • Allow at least 24 hours for data to start to be populated across devices.

  • There are limitations to how much data can be transferred via iCloud over short periods of time. This means when performing a manual sync using the Sync Now button, not all data for the selected period may be transferred at once. In this case, try selecting shorter date ranges.

  • If data is not visible on Mac/Vision Pro after completing the steps above, try quitting then relaunching the app.

  • You must have Premium access to continue to sync data after the app trial period has ended.

Further documentation on issues with background syncing is available here.