How Health Record Importer works
On this page
Health Record Importer copies information from health records you already have, such as files downloaded from a patient portal, readings from a blood pressure monitor or scale, and glasses or contact lens prescriptions, into the Apple Health app on your iPhone or iPad. Files you choose are processed entirely on your device. It can add data to Apple Health, but it doesn't have permission to read the data already there.
Health Record Importer does not give medical advice and is not a medical device. It copies information from your records and does not interpret, diagnose, or recommend anything. It can misread records, so always check what it adds against the originals.
The Records tab#
Use the Records tab for files downloaded from a patient portal, such as a visit summary or a copy of your health record.
Files it can read
- CDA / C-CDA clinical documents (XML). This is the format most US patient portals, including Epic MyChart, use for downloadable visit summaries and health records.
- FHIR files in XML, JSON, or NDJSON.
- CSV, TSV, and Excel (.xlsx) spreadsheets, such as exports from blood pressure monitors, scales, glucose meters and continuous glucose monitors, pulse oximeters, and patient portals, or a log you keep yourself. The app reads two layouts:
- A date column and a column for each measurement, such as Date, Weight (kg), Systolic (mmHg), Diastolic (mmHg), and Pulse. The unit can be in the column name or after each value, such as 86.3 kg. Weight, height, glucose, distance, energy, water, and lung test columns need a unit, because 70 could be kilograms or pounds. Heart rate, blood pressure, oxygen saturation, body fat percentage, BMI, temperature, and steps don't. If a column has no unit, open the file in the Readings tab and choose it there.
- A row for each measurement, with its name or code, value, unit, and date, the way lab result exports write them.
The app finds the row with the column names even when report details come first, and reads commas, semicolons, or tabs between columns, decimal commas such as 75,4, and full-width characters. It recognizes column names in English, Spanish, Portuguese, French, German, Japanese, Korean, and Chinese. Dates can be written many ways, such as 2026-09-20, Sep 20, 2026, 20.09.2026, 20 de septiembre de 2026, or 2026年9月20日. A date written with numbers and slashes, such as 03/04/2026, is read the way your region writes dates unless the file shows otherwise, such as with 13/04/2026 in the same column or semicolons between columns. Text files saved in older encodings, such as Shift JIS or Windows Latin 1, are read too.
- ZIP files containing any of the above. The app opens them in memory and doesn't save the files inside to your device.
- PDF and other files are recognized but not imported on this tab. Use the Vision Rx tab for prescription PDFs.
You can choose individual files or a whole folder, including a folder in iCloud Drive. Files that haven't downloaded to your iPhone or iPad yet are downloaded first.
What it adds to Apple Health
- Clinical documents. Each CDA file is saved to Apple Health as one or more clinical documents. The app groups the file's entries by the date each one happened and saves one document per day, so each entry appears on the day it happened. Entries without a date, along with goals and plans, go into one more document with the original file's date. Apple Health shows each document's title, author, and organization.
- Measurements, each on the date and time it was taken:
- weight, height, body mass index, waist circumference, body fat percentage, and lean body mass
- body temperature (with where it was taken, such as oral or ear, when the record says) and basal body temperature
- heart rate, blood pressure, oxygen saturation, and respiratory rate
- blood glucose (marked as before a meal when the record says it was fasting)
- peak expiratory flow, FEV1, and forced vital capacity
- from spreadsheets, also steps, walking and running distance, active energy, flights climbed, resting heart rate, heart rate variability, cardio fitness (VO2 max), and water. A day's total, such as steps with a date but no time, covers that whole day.
- Symptoms. When a clinician recorded a symptom that Apple Health tracks, such as cough, wheezing, shortness of breath, nasal congestion, runny nose, sore throat, fever, headache, fatigue, nausea, dizziness, or palpitations, it is saved to Symptoms on the date in the record. The severity is left unspecified.
In Apple Health, each measurement and symptom shows the clinic or organization from your record in its Device field, and Health Record Importer as its source.
How values are recognized
- A measurement is recognized by its standard laboratory code when the record includes one.
- A value whose code isn't one of the types above, such as a cholesterol or sodium result, is not added as a measurement. It stays in the clinical document.
- A value with no standard code is added only when its label names a supported measurement and nothing else (for example "Weight" or "Pulse", but not "Dry weight" or "Glucose, urine") and its unit can be converted.
- Values that are goals, plans, estimates, changes, percentiles, or measurements from someone else (such as family history) are not added.
- A value outside the range a person could have, such as a heart rate of 700, isn't added, and neither is a value in a unit the app doesn't recognize. The file's card lists these values so you can check them in the original.
- A measurement is dated when it was taken. If a record gives only the date a result was released, the value isn't added.
- Units are converted to Apple Health's standard units, for example pounds to kilograms and Fahrenheit to Celsius.
- Symptoms come only from standard diagnosis codes. Diseases such as allergic rhinitis or asthma are not symptoms and are not added to Symptoms.
What it can't add
Medications, immunizations, allergies, diagnoses, procedures, and most laboratory results are kept inside the saved clinical document, where you can read them in Apple Health. The app imports copies of files you already have; it doesn't link your patient portal account to Apple Health.
Importing the same file again
Importing the same file again doesn't create duplicates, and a newer version of a record replaces the older one. When a record doesn't give a value its own ID, the app matches it by code, date, and value instead, so a value that was later corrected in the source may be saved as a new entry.
The Readings tab#
Use the Readings tab for spreadsheets of readings, such as exports from blood pressure monitors, scales, glucose meters, pulse oximeters, and fitness trackers or their apps, or a log you keep yourself. It reads CSV, TSV, and Excel (.xlsx) files, and lets you check each one before anything is added.
- Tap Choose Files. You can choose several files at once.
- Open a file to check how it's read:
- Dates: the line with the column names, the column that holds each reading's date, and a separate time column if there is one. When every date in the file could be read either way, such as 03/04/2026, choose the date order, and check it against the first reading shown.
- Columns: for each column, choose what it holds in Apple Health, such as Weight or Blood Glucose, or Not Added. Columns the app doesn't recognize start as Not Added. When a column has no unit, choose its unit, such as kg or lb, or its values won't be added.
- What will be added: the first reading, the range of dates, and the lowest and highest value of each type, so you can spot a wrong unit or date order. Tap Review Entries to see every entry and turn off any you don't want to add.
- Left out: values that weren't added, with the line they're on and why, such as a number the app can't read or a value outside the usual range.
- Only Add Readings Between: limits the import to a range of dates, for example when part of the file is already in Apple Health.
- Tap Import to Apple Health. When the import is done, Open Apple Health shows you where the entries went.
Importing a file again from the Readings tab replaces what it added before, so if a unit or date order was wrong, correct it and import the file again. Entries are matched by their column and time. If you've cleared the file or closed the app since, a corrected unit still replaces what was added, but a corrected date order or column type adds new entries, so delete the earlier ones in Apple Health.
The Vision Rx tab#
Use the Vision Rx tab for glasses and contact lens prescriptions, which usually arrive as a PDF or a photo.
- Tap Choose PDF or Photo, or tap Enter Manually.
- The app reads the prescription on your device. For a PDF, it uses the text in the file when it can; otherwise it reads the text from the image.
- It fills in a form: sphere, cylinder, axis, add, prism and base, distance and near pupillary distance for each eye (glasses), base curve and diameter (contacts), lens brand, issue and expiration dates, and the clinic. A preview of the original and the text found in the file appear above the form. Apple Health records each eye's pupillary distance from the nose to the pupil, so a single PD for both eyes, such as 64, isn't filled in. Enter each eye's PD if your prescription lists them.
- Check every value against the original and correct anything that's wrong. Text recognition can misread numbers, signs (+ or −), decimal points, and which eye a value belongs to. Dates written with numbers are read month first (US style) unless the first number can only be a day or your region writes the day first. The app reads prescriptions with labels in English, Spanish, Portuguese, French, German, Japanese, Korean, and Chinese, such as OD and OS, OI, OG, or 右 and 左.
- Turn on "I checked every value against the original," then tap Save to Apple Health. Changing any value turns the confirmation off again. The prescription is saved as a glasses or contacts prescription with the original file attached. A photo's location and camera details are removed before it's attached; the picture itself isn't changed. Saving again from the same file, or from the same manual entry, replaces the earlier copy.
Permissions#
The app asks Apple Health only for permission to write the specific kinds of data found in your files. It doesn't ask to read the data already in Apple Health. You can change these permissions at any time in Settings › Apps › Health › Data Access & Devices › Health Record Importer.
Finding and removing what was added#
- In the Health app, open Browse and choose a category, or search for a type such as Weight or Vision Prescription. Clinical documents appear under Health Records.
- To remove everything this app has added, open Settings › Apps › Health › Data Access & Devices › Health Record Importer and choose Delete All Data. You can also delete individual entries in the Health app.
Free trial and Unlimited Imports#
The app is free to try. Without a purchase, it imports one visit, or one day of readings from the Readings tab, and saves one glasses or contact lens prescription. A visit is everything in your files dated on one day. When your files cover several days, the free trial imports the latest one.
To import more, buy Unlimited Imports from the screen that opens after the free visit, or tap Unlock Unlimited Imports in the About tab. It's a one-time purchase with no subscription, and the price is shown before you buy. Family members in your Family Sharing group can use it too. If it doesn't show as unlocked on another device, tap Unlock Unlimited Imports in the About tab, then Restore Purchases.
Tips#
If you'd like to leave a tip, tap Leave a Tip in the About tab and choose one. Tips are optional one-time payments through the App Store, and Apple handles the payment and any refunds. They don't unlock anything, so there's nothing to restore on your other devices.
Your responsibilities#
You are responsible for choosing the right files, checking everything the app reads and saves, and keeping your own copies of your original records. Use of the app is subject to the Terms of Use and the Privacy Policy, which you can read in the About tab.