Training
Apple Watch Integration
What it is
Apple Watch integration means Diorama can use data your watch records (workouts, heart rate, activity, and sleep) through Apple Health (HealthKit). Diorama does not pull from the watch directly. It reads what has been saved to the Health app.
Why it matters
When Apple Watch data is flowing reliably into Apple Health, Diorama can show more complete trends and give better context across training, recovery, and habits. It also reduces manual tracking because many signals can be captured automatically.
How Diorama Health uses this
Diorama requests HealthKit permissions and then reads supported categories like workouts, heart rate, sleep, steps, and related signals. We use these to populate the Daily Card, Insights trends, and coaching-style explanations (always non-clinical).
Getting Apple Watch Data Into Diorama (The Simple Mental Model)
Think of Apple Watch integration as a two-step pipeline:
- Apple Watch records data (workouts, heart rate, sleep).
- Apple Health stores it on your iPhone, and Diorama reads it from there.
If you don’t see a metric in Diorama, a simple way to orient is to ask: “Is the data in the Health app?” If it’s in Health but not in Diorama, it’s often a permission issue. If it’s not in Health, it’s usually a recording or sync issue.
Step 1: Confirm the watch is recording what you expect
- For workouts: start workouts from the Apple Watch Workouts app (or a compatible third-party workout app).
- For heart rate: ensure the watch is snug enough for the sensor and that heart rate tracking is enabled in watch settings.
- For sleep: enable sleep tracking, set a sleep schedule, and wear the watch overnight.
Step 2: Confirm the data arrived in Apple Health
Open the Health app and look at the relevant section (Workouts, Heart Rate, Sleep). If the data is present there, the pipeline is working.
Step 3: Confirm Diorama has permission
In the Health app, go to Sharing > Apps > Diorama and ensure the categories you care about are enabled (workouts, heart rate, sleep, etc.). If you recently changed permissions, it may take a short moment for Diorama to reflect the new access.
A friendly tip: treat this as “sync, then view”
If you just finished a workout or woke up, give your watch a moment to sync with your iPhone (Bluetooth/Wi-Fi). Opening the Health app or Diorama after a short delay often makes new data appear.
Limitations
Data can be delayed if your watch hasn’t synced to your iPhone yet. Some metrics depend on how the watch is worn and whether tracking is enabled (especially sleep). Apple Health privacy settings can also block Diorama from reading specific data types.
Frequently asked questions
How does Apple Watch data get into Diorama?
Your Apple Watch records data, your iPhone saves it in the Health app, and Diorama reads it from there. If a metric is missing, first check whether it exists in Apple Health.
Why might my watch data not show up in Diorama?
Most issues fall into a few buckets: the watch has not synced yet, the data is not present in Apple Health, or Diorama does not have permission to read that category in the Health app.
What is the quickest checklist to fix missing data?
1) Confirm it appears in the Health app. 2) Confirm permissions in Health > Sharing > Apps > Diorama. 3) Give the watch a minute to sync, then reopen Diorama.
Ask Ray
Chat with Ray on this topic.
Ray is your AI health coach in Diorama Health. Open the app to ask follow-up questions, connect this to your personal data, and get guidance tailored to you.