> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gymlive.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Health Connect Integration

> Connect Health Connect (Android) with GymLive to sync your Android health data

# Health Connect (Android) Integration

Health Connect is Google's unified health platform for Android that allows you to manage your fitness and health data from multiple apps in one place. By connecting Health Connect to GymLive, your coach can monitor your workouts and health metrics across all your Android fitness apps.

<Info>
  Health Connect comes pre-installed on devices running Android 14+. For older Android versions, you can download it from the Google Play Store.
</Info>

## What Data Can Be Synced?

Health Connect allows GymLive to access data from all your connected fitness apps:

* **Activity Metrics**: Steps, distance, calories, active minutes
* **Workouts**: Strength training, cardio, sports activities
* **Heart Rate**: Resting, active, and exercise heart rates
* **Sleep Data**: Duration, stages, and quality
* **Body Measurements**: Weight, body fat, muscle mass
* **Nutrition**: Water intake, macros (if tracked)
* **Recovery**: Heart rate variability, stress levels

## Setup Instructions

<Steps>
  <Step title="Install Health Connect (if needed)">
    For Android 13 and below:

    1. Open **Google Play Store**
    2. Search for **"Health Connect"**
    3. Install the official app by Google LLC
    4. Open Health Connect once installed

    <Note>
      Android 14+ users can skip this step as Health Connect is pre-installed.
    </Note>
  </Step>

  <Step title="Connect GymLive to Health Connect">
    In the GymLive app:

    1. Go to **Settings** > **Integrations**
    2. Select **Health Connect**
    3. Tap **Connect Health Connect**
    4. You'll be redirected to Health Connect permissions
  </Step>

  <Step title="Grant Permissions">
    In the Health Connect permission screen:

    1. Review the data types GymLive requests
    2. Toggle **ON** each data type you want to share
    3. Tap **Allow** to confirm

    <Warning>
      Grant at least Steps and Workout permissions for basic functionality.
    </Warning>
  </Step>

  <Step title="Connect Other Apps to Health Connect">
    To sync data from other fitness apps:

    1. Open **Health Connect** app
    2. Tap **App permissions**
    3. Select apps you want to connect (Samsung Health, Google Fit, etc.)
    4. Grant permissions for each app
    5. Data from these apps will now flow through Health Connect to GymLive
  </Step>
</Steps>

## Accessing Health Connect

You can access Health Connect in multiple ways:

<Tabs>
  <Tab title="Via Settings">
    1. Go to **Settings** > **Apps** > **Health Connect**
    2. Tap **Open**
  </Tab>

  <Tab title="Via Quick Settings">
    1. Swipe down from the top of your screen
    2. Look for the Health Connect tile
    3. Tap to open (add tile if not visible)
  </Tab>

  <Tab title="Via Privacy Settings">
    On Android 14+:

    1. Go to **Settings** > **Privacy**
    2. Select **Health Connect**
  </Tab>
</Tabs>

## Managing Connected Apps

### View Connected Apps

1. Open **Health Connect**
2. Tap **App permissions**
3. See all apps with access to your health data

### Modify App Permissions

1. In App permissions, select an app
2. Toggle specific data types on/off
3. Changes take effect immediately

### Data Source Priority

When multiple apps track the same data:

1. Go to **Health Connect** > **App permissions**
2. For each data type, you can set which app is the primary source
3. GymLive will receive data based on these priorities

## Syncing with Popular Apps

### Google Fit Integration

<Accordion title="Connect Google Fit to Health Connect">
  1. Open **Google Fit** app
  2. Tap **Profile** > **Settings**
  3. Under 'Health Connect', tap **Manage data and access**
  4. Enable **Google Fit** as a Health Connect data source
  5. Select data types to sync
</Accordion>

### Samsung Health Integration

<Accordion title="Connect Samsung Health to Health Connect">
  1. Open **Samsung Health** app
  2. Go to **Settings** > **Health Connect**
  3. If not installed, follow prompts to install
  4. Grant permissions for data types
  5. Enable **Sync with Samsung account**
  6. Tap **Sync now**

  <Note>
    Enable permissions via Samsung Health > Settings > Health Connect, not through phone Settings.
  </Note>
</Accordion>

## Troubleshooting

<AccordionGroup>
  <Accordion title="No data syncing to GymLive">
    1. Verify Health Connect is installed and updated
    2. Check GymLive has permissions in Health Connect
    3. Ensure source apps (Google Fit, Samsung Health) are connected
    4. Force stop and restart GymLive
    5. Check that data exists in the source apps first
  </Accordion>

  <Accordion title="Samsung Health data not appearing">
    Common issue with Health Connect integration:

    1. In Samsung Health: Settings > Health Connect > App permissions
    2. Ensure Samsung Health is enabled
    3. Go to Settings > Sync with Samsung account
    4. Tap "Sync now" and wait 2-3 minutes
    5. If issues persist, try disconnecting and reconnecting
  </Accordion>

  <Accordion title="Health Connect permission errors">
    1. Uninstall and reinstall Health Connect
    2. Clear app cache: Settings > Apps > Health Connect > Storage > Clear Cache
    3. Revoke all permissions and re-grant them
    4. Ensure all apps are updated to latest versions
  </Accordion>

  <Accordion title="Missing historical data">
    Health Connect only shares:

    * Data from the last 30 days before connection
    * All new data after connection
    * For older data, check if source app has export options
  </Accordion>
</AccordionGroup>

## Known Limitations

<Warning>
  **Health Connect Platform Issues**

  As Health Connect is relatively new, you may encounter:

  * Sync delays between apps
  * Occasional data gaps
  * Some apps not fully supporting all data types
  * Need to apply for Google permissions before app release
</Warning>

## Privacy & Security

* Health Connect stores data locally on your device
* You control which apps can read/write specific data types
* Data is encrypted and never leaves your device without permission
* Each app must request specific permissions
* You can delete all Health Connect data at any time

## Best Practices

<CardGroup cols={2}>
  <Card title="Regular Syncing" icon="sync">
    Open source apps daily and pull down to sync
  </Card>

  <Card title="Single Source" icon="filter">
    Use one primary app per data type to avoid conflicts
  </Card>

  <Card title="Keep Updated" icon="download">
    Update Health Connect and all connected apps regularly
  </Card>

  <Card title="Check Permissions" icon="shield-check">
    Review app permissions monthly to ensure proper access
  </Card>
</CardGroup>

## Data Management

### Viewing Your Data

1. Open Health Connect
2. Browse by data category
3. See combined data from all connected apps

### Deleting Data

1. In Health Connect, select a data category
2. Choose specific entries or date ranges
3. Tap delete icon
4. Confirm deletion

<Note>
  Deleting data in Health Connect doesn't delete it from the source apps.
</Note>

## Related Resources

* [Official Health Connect Guide](https://developer.android.com/health-and-fitness/guides/health-connect)
* [GymLive Troubleshooting Guide](/integrations/troubleshooting)
* [Samsung Health Integration](/integrations/health-aggregators/samsung)