Docs

For athletes

Connect your watch or ring

Connect your watch, band, or ring, and your check-in can fill in numbers from last night without you typing them in. The mobile app reads data from three sources: Apple Health, WHOOP, and Oura. You can connect one or more. Apple Health also adds heart rate to your completed sessions, and it can match the workouts your watch recorded to the sessions you recorded in the app.

All three are in Profile, in the Connected group.

The Connected group in Profile: Apple Health, WHOOP, Oura, and Readiness source rows

Connecting Apple Health

  1. Open the Apple Health row

    Open Profile and find the Connected group. Tap Apple Health.

  2. Review what the app reads

    The sheet lists What Gridlines reads: workouts, heart rate, walking and running distance, active energy, heart rate variability, resting heart rate, and sleep.

  3. Allow access

    Tap Connect Apple Health. iOS asks which data to share. Allow the types you want the app to read.

The row then reads Connected. To change access later, open the Health app on your iPhone, then Sharing.

The Apple Health connect sheet: what Gridlines reads, and the Connect Apple Health button

If you connected before the app read sleep and heart data, the row reads Update access. Tap it, then tap Update Health access to add them.

Connecting WHOOP

You need a WHOOP account. You sign in on WHOOP's own page, so the app never sees your WHOOP password.

  1. Open the WHOOP row

    Open Profile and find the Connected group. Tap WHOOP. The screen shows Not connected.

  2. Review what the app reads

    What Gridlines reads lists Recovery, Heart rate variability, and Sleep. Gridlines reads this data on its servers, not on your phone.

  3. Tap Connect WHOOP

    WHOOP's sign-in page opens inside the app. If Safari already has your WHOOP login, you can skip the sign-in.

  4. Allow access on WHOOP

    Sign in and allow Gridlines to read your data. WHOOP then sends you back to the app.

The WHOOP screen: Not connected, What Gridlines reads (Recovery, Heart rate variability, Sleep), and the Connect WHOOP button

The screen then reads Connected, with the Connected date and the Last sync time. When you connect, the app reads your last 14 days of recoveries.

Connecting Oura

You need an Oura account. You sign in on Oura's own page, so the app never sees your Oura password.

  1. Open the Oura row

    Open Profile and find the Connected group. Tap Oura. The screen shows Not connected.

  2. Review what the app reads

    What Gridlines reads lists Readiness, Heart rate variability, and Sleep. Gridlines reads this data on its servers, not on your phone.

  3. Tap Connect Oura

    Oura's sign-in page opens inside the app. If Safari already has your Oura login, you can skip the sign-in.

  4. Allow access on Oura

    Sign in and allow Gridlines to read your data. Oura then sends you back to the app.

The Oura screen: Not connected, What Gridlines reads (Readiness, Heart rate variability, Sleep), and the Connect Oura button

The screen then reads Connected, with the Connected date and the Last sync time. When you connect, the app reads your last 14 days of Oura data.

If the connection fails

The WHOOP or Oura screen shows the reason in a line above the button. The messages for WHOOP are below. The Oura screen shows the same messages with Oura's name.

  • You did not allow Gridlines to read your WHOOP data. — you declined access on WHOOP's page. Tap Connect WHOOP again and allow it.
  • The connection timed out. Try again. — the sign-in took too long. Tap Connect WHOOP again.
  • That WHOOP account is already linked to another Gridlines athlete. — one WHOOP or Oura account links to one athlete only. Disconnect it from the other athlete first.

If you close the sign-in page, nothing changes. Tap Connect WHOOP or Connect Oura to start again.

What fills in your check-in

Your coach can set a number question in your check-in to fill in from a device. The choices are hours of sleep, HRV, resting heart rate, and the recovery score from WHOOP or Oura. The app fills in last night's number, and you can change it before you send. If the device has nothing for last night, you type the answer yourself.

You can pick which device fills in your check-in under Fill in my check-in from, in Preferences > Devices on the web. On Auto, the first device that has last night fills it in, in this order: WHOOP, then Oura, then Apple Health. If you pick one device, the next one in that order fills in on a night it has nothing.

  • WHOOP and Oura — from WHOOP, the recovery score is WHOOP's daily recovery. From Oura, it is Oura's daily readiness score. Gridlines uses the number the vendor sent.
  • Apple Health — sleep and heart data, but no recovery score.

Gridlines reads new WHOOP and Oura data every hour. WHOOP and Oura also tell Gridlines when their data changes. To read new data now, open the WHOOP or Oura screen and tap Sync now. After a sync, the button reads Sync again in N s for up to a minute.

Your coach sees your check-in answers, including the numbers a device filled in. See Answer your coach's forms.

Disconnecting WHOOP or Oura

  1. Open the vendor screen

    Open Profile, find the Connected group, and tap WHOOP or Oura.

  2. Tap Disconnect

    The app asks Disconnect WHOOP? or Disconnect Oura?.

  3. Confirm

    Tap Disconnect. To cancel, tap Keep connected.

Gridlines stops reading your data and deletes its login for that account. Data already saved stays in your history. For Oura, Gridlines also removes its access on Oura's side.

If the row reads Reconnect, the vendor stopped accepting the link. Open the screen and tap Reconnect WHOOP or Reconnect Oura.

Matching watch workouts to sessions

When you record a workout on your watch and also record it in the app, the app can suggest a match. Open Profile > Apple Health to see Suggested matches. Each card shows your session beside what the watch recorded:

  • Link — joins the watch workout to your session.
  • Not a match — dismisses the suggestion.

Linking never changes your sets, your totals, or your session.

Stuck? Message us directly.