Skip to content

Syncing Troubleshooting

Solutions for health sync and cloud sync issues.

Health Syncing Issues

Workouts Not Syncing

Problem: Completed workout doesn't appear in your health platform.

Solutions:

1. Check Sync Status - Open History tab - Expand the workout - Check sync status: - ✅ Synced - Workout is in your health platform - ⏳ Pending - Waiting to sync - ❌ Failed - See error message

2. Verify Health Integration Enabled

  • Settings > Apple Health
  • Toggle Enable Apple Health Integration must be ON

3. Check Permissions

  • iOS Settings > Health > Data Access & Devices > Treadmill Assistant
  • Verify Workouts permission has Write enabled
  • Toggle OFF then ON if needed

4. Enable Auto-Save

  • Settings > Apple Health
  • Toggle Auto-Save Workouts ON

5. Manual Sync

  • Settings > Apple Health
  • Tap Sync Workouts button

6. Check Health App

  • Open Health app
  • Browse > Activity > Workouts
  • Verify workout appears

2. Verify Health Connect Integration Enabled

  • Settings > Health Connect
  • Toggle Enable Health Connect Integration must be ON

3. Check Permissions

  • Android Settings > Health Connect > App permissions > Treadmill Assistant
  • Verify Exercise permission is granted

4. Enable Auto-Save

  • Settings > Health Connect
  • Toggle Auto-Save Workouts ON

5. Manual Sync

  • Settings > Health Connect
  • Tap Sync Workouts button

6. Check Android Version

  • Health Connect requires Android 14 or later
  • Check: Android Settings > About phone > Android version

Sync Status Stuck on Pending

Problem: Workouts show orange "Pending" status indefinitely.

Solutions:

1. Force Manual Sync

  • Settings > Apple Health > Sync Workouts
  • Should change to Synced or Failed

2. Check Write Permission

  • iOS Settings > Health > Treadmill Assistant
  • Workouts must have Write access

3. Restart App

  • Close Treadmill Assistant completely
  • Reopen app

4. Check Health App Restrictions

  • iOS Settings > Screen Time > Content & Privacy Restrictions
  • Ensure Health app is not restricted

Solutions:

1. Force Manual Sync

  • Settings > Health Connect > Sync Workouts
  • Should change to Synced or Failed

2. Check Permission

  • Android Settings > Health Connect > App permissions > Treadmill Assistant
  • Exercise permission must be granted

3. Restart App

  • Close Treadmill Assistant completely
  • Reopen app

4. Verify Health Connect Running

  • Open Health Connect from Android Settings
  • If not installed, install from Google Play

Sync Failed with Error

Problem: Red error icon with specific error message.

Common Errors:

Error Message Meaning Solution
"Permission denied" Health write permission revoked Grant in iOS Settings > Health
"Health not available" Health app disabled or restricted Check Screen Time restrictions
"Invalid workout data" Workout data corrupted Delete and redo workout
"Unknown error" Generic sync failure Restart app and try manual sync

General Solution:

  1. Note the specific error message
  2. Check permissions (iOS Settings > Health)
  3. Try manual sync (Settings > Apple Health > Sync Workouts)
  4. Restart app if persists

Common Errors:

Error Message Meaning Solution
"Permission denied" Health Connect permission revoked Grant in Android Settings > Health Connect
"Health Connect not available" Requires Android 14+ Check Android version
"Invalid workout data" Workout data corrupted Delete and redo workout
"Unknown error" Generic sync failure Restart app and try manual sync

General Solution:

  1. Note the specific error message
  2. Check permissions (Android Settings > Health Connect)
  3. Try manual sync (Settings > Health Connect > Sync Workouts)
  4. Restart app if persists

Cloud Sync Issues

Cloud Sync Not Working

Problem: Changes not syncing to the cloud or other devices.

Solutions:

1. Check iCloud Sign-In

  • iOS Settings > [Your Name]
  • Verify signed into iCloud
  • Same Apple ID on all devices

2. Enable iCloud Drive

  • iOS Settings > [Your Name] > iCloud > iCloud Drive
  • Toggle ON

3. Enable Sync in App

  • Settings > iCloud Sync
  • Toggle Enable iCloud Sync ON

4. Check Internet Connection

  • iCloud sync requires network
  • Connect to Wi-Fi or cellular

5. Check iCloud Storage

  • iOS Settings > [Your Name] > iCloud
  • Verify storage not full

Solutions:

1. Check Google Account

  • Verify you're signed into a Google account on your device
  • Try signing in again if prompted

2. Enable Sync in App

  • Settings > Google Drive Sync
  • Tap to enable and sign in with Google when prompted

3. Check Internet Connection

  • Google Drive sync requires network
  • Connect to Wi-Fi or cellular

4. Check Google Drive Storage

  • Open Google Drive app and check available storage

Last Synced Shows Old Timestamp

Problem: "Last Synced" shows hours or days ago.

Solutions:

  1. Force sync from Settings (Sync Now button)
  2. Check internet connection
  3. Restart the app
  4. Disable and re-enable cloud sync

Data Not Appearing on Second Device

Problem: Workouts/programs on Device A don't show on Device B.

Solutions:

  1. Verify both devices use the same Apple ID
  2. Enable iCloud Sync on both devices
  3. Force sync on both (Sync Now)
  4. Wait a few minutes for propagation

Solutions:

  1. Verify both devices use the same Google account
  2. Enable Google Drive Sync on both devices
  3. Force sync on both (Sync Now)
  4. Wait a few minutes for propagation

Cloud Sync Keeps Failing

Problem: Sync attempts always fail.

Solutions:

1. Check iCloud Status

  • Visit apple.com/support/systemstatus
  • Verify iCloud Drive is operational

2. Check Storage

  • iOS Settings > [Your Name] > iCloud > Manage Storage
  • Treadmill Assistant needs <15 MB typically

3. Network Issues

  • Try different Wi-Fi network or cellular data

4. Sign Out and Back In

  • Warning: Make sure data is backed up first
  • iOS Settings > [Your Name] > Sign Out
  • Sign back in and re-enable sync in app

Solutions:

1. Check Google Services

  • Verify Google Drive works in other apps

2. Check Storage

  • Open Google Drive and check available space

3. Network Issues

  • Try different Wi-Fi network or cellular data

4. Re-Authenticate

  • Disable Google Drive Sync in app
  • Re-enable and sign in again when prompted

Permissions Issues

Cannot Grant Health Permissions

Problem: Health permission dialog doesn't appear or won't save selections.

Solutions:

1. Check Health App Restrictions

  • iOS Settings > Screen Time > Content & Privacy Restrictions
  • Apps > Health must be allowed

2. Grant via iOS Settings

  • iOS Settings > Health > Data Access & Devices > Treadmill Assistant
  • Manually toggle permissions ON

3. Delete and Reinstall App

  • Delete Treadmill Assistant
  • Reinstall from App Store
  • Permission dialog should appear on first launch

Solutions:

1. Check Health Connect Installed

  • Health Connect requires Android 14+
  • Open Health Connect from Android Settings

2. Grant via Android Settings

  • Android Settings > Health Connect > App permissions > Treadmill Assistant
  • Grant Exercise permission

3. Delete and Reinstall App

  • Uninstall Treadmill Assistant
  • Reinstall from Play Store
  • Permission dialog should appear when enabling integration

Conflict Resolution

Duplicate Workouts

Problem: Same workout appears twice in History or your health platform.

Solutions:

  1. In Treadmill Assistant History, swipe left and delete the duplicate
  2. Choose whether to also delete from your health platform
  3. To prevent future duplicates, let the app handle syncing automatically — don't manually add workouts

Data Conflicts

Problem: Different data on different devices after cloud sync.

Solutions:

  1. Cloud sync uses "last write wins" (newest change kept) — this is automatic
  2. To force consistency: on your "source of truth" device, force sync, wait a few minutes, then disable and re-enable cloud sync on the other device

Getting More Help

If syncing still doesn't work:

  1. Check Apple's Health documentation
  2. Verify iOS is up to date (Settings > General > Software Update)
  3. Check iCloud system status (apple.com/support/systemstatus)
  4. Report issue to Treadmill Assistant support
  1. Verify Android is up to date (Settings > System > Software update)
  2. Check Health Connect is installed and up to date
  3. Verify Google Drive works in other apps
  4. Report issue to Treadmill Assistant support

More questions? Check the FAQ.