Blue Button® Portal-Issue Alerts

What's New


First Time Use

Creating Multiple Profiles

Acquiring Records from Blue Button® Portals

The MyMedicare Blue Button Record

Acquiring Records using a DIRECT Address

Other ways to get Records into the App

The Summary Record

Privacy and Security

iBlueButton for Android

Spread the Word

Blue Button Portal-Issue Alerts[top]

iOS Users
Please remember to update your iBlueButton app to the newest release (verson 7.10). The previous release had a compatibility issue with new iOS versions that prevented the proper download of MyHealteVet and Medicare records.

Tricare Online - iBlueButton is not supporting Tricare Online downloads at this time. Check back soon!
Tricare now requires changing your password every 90 days. After changing your password through the web portal be sure to update your iBlueButton Tricare login credentials with your new password to continue to download your records. You will need to do this every 90 days or sooner.

What's New[top]

What is the iBlueButton app?

For a short overview of iBlueButton view this video.

How do I find the App’s Current Release Number?

You can find the app’s latest release number at iTunes under the app’s “Information” section. There is also a “full version number” that can be helpful if you report an issue with the app. To find the full release number for the version you have installed, tap “About” in the lower-right of the Profile screen and the app’s current, fully-qualified version number is displayed as the header of the About screen. This number is the “fully-qualified” version, meaning it has all digits of the version number. If you require support for the app and contact Humetrix, we may ask you for this entire version number.

How do I Update My Version of the App?

For Apple devices, if you are running the latest version of Apple’s iOS operating system, the app should be updated automatically when we publish new versions of the app. If this doesn’t seem to be the case, open the Apple app, “App Store”, tap “Updates” in the lower right, scroll down until you get to the iBlueButton app, and then tap the “UPDATE” button.


What is the iBlueButton App?

The iBlueButton® iPhone app is an award winning app designed by a team of physicians and technologists specifically to serve Medicare beneficiaries, Veterans, individuals covered by TRICARE and their family caregivers. With iBlueButton, users have at all times their medical information in their hands, so that they can better manage their healthcare and those of your loved ones. iBlueButton won the U.S. Department of Health and Human Services (HHS) Investing in Innovation competition for Blue Button, a federal initiative giving Veterans and American covered by Medicare or TRICARE the ability to download their health records from the patient portals offered by these federal programs.

What is Blue Button?

Blue Button is a national initiative, launched by the Center for Medicare and Medicaid Services (CMS), the Veterans Administration and the Department of Defense to give Americans served by these federal agencies easy access to their health records

What Platforms / Devices Does iBlueButton Run On?

iBlueButton is currently available on iOS devices (iPhone, iTouch, iPad and iPad Mini) and Android Phones.

Can I Run iBlueButton on an iPad or iPad Mini?

Yes, the iBlueButton app runs great on an iPad.

Who Makes the iBlueButton App?

iBlueButton is the creation of, a privately-help, healthcare information technology (HIT) company with over 20 years of experience developing novel mobile-health solutions. Located in the city of Del Mar in the north-coastal part of San Diego County, you can learn more about Humetrix from our website at

First Time Use[top]

Do I Have To Create a Password for the App?

No, the app does not require you to set a password for it; this is optional. If you do not want to password protect the app, just tap “I don’t want to use a password” during your first time use of the app.

Why Would I Want a Password for the App?

Although not required, we do encourage you to set a password for the app as this adds an additional level of security for the access to your personal health information stored on your mobile device through the app. Since many people prefer to secure their personal health information, we have added this optional password. When you have a password set, every time you leave the app in any way and return to it, you are required to enter in the password.

Why Would I NOT Want a Password for the App?

It’s a personal preference, really. If you are the only person who uses your device, and you have already set-up a passcode for the device (or have a biometric recognition set for the device such as is available on iPhone models), you may not see the need for this additional password setting for the iBlueButton app itself.

How Can I Reset My Password and Password-Protection Choice?

When you are on the Profiles screen, simply tap “Reset” in the lower-left-hand corner to change your password and/or change your password-protection choice (from requiring or not-requiring a password).

What’s a Profile?

A profile is the representation of one person, and is used to store all of the personal information and medical records for that person in the app.

After this first password selection step, you can add your first profile to the app by selecting “Add a Profile”. We encourage you to complete all the information you can as your profile information will be included as part of any Blue Button or other health information you share with a provider, making it easier for a given provider to have quick access to your complete profile. On this screen, you will also see the option “Add from Address Book +”. If you tap this, you will be able to quickly add Profile information from one of your phone’s contact. For example, if you are creating a profile for an elderly parent and you have that parent’s contact information already on your phone, you can tap this option to quickly add that contact’s fields to this profile.

What Data is Required in a Profile?

At a minimum, the first and last name are required fields in a profile. We need at least these two fields to create a suitable profile name and DIRECT Address for the Profile (see below for more information on DIRECT Addresses).

What Does a Complete Profile Contain?

When you tap down on a created profile and then tap down on Settings, we give you a number of additional important features regarding the currently-selected profile. When you tap “Update Profile” from the Settings screen, you will see some helpful additional information over-and-above the Personal Details you may have entered for the profile when it was first created:

  1. My Personal Details – Go back to this to update the core information about this profile, including adding a photo for the profile.
  2. My DIRECT Address – This is where you can access the unique DIRECT Address created for the profile.
  3. My Emergency Contact – Let’s you add an emergency contact for the profile, and you can also pick from your Contacts list to make it fast and easy to do this.
  4. My Primary Physician – Enter in all of the details for this profile’s Primary Physician.
  5. My Insurance Information – Enter in all of the insurance details for this profile, including the ability take a picture of your insurance card.
  6. My Secondary Insurance – Enter in the details and card for any secondary insurance.
  7. My Pharmacy – Enter in the Pharmacy details for this profile, including the ability to pick from your Contacts.

What is “Add from Address Book+”?

This convenient feature automatically fills out the core Profile fields from one of your phone’s contact. For example, if you are creating a profile for your husband or wife and you already have their contact information in your phone’s contacts, then you can use this feature to quickly populate the core Profile fields for this Profile.

Can I Add a Medical Insurance Card to a Profile?

Yes, under both a profile’s “My Insurance Information” and “My Secondary Insurance”, you have the option of taking a photo of your insurance card and thereby adding it to a given profile.

What’s a Portal?

A portal as we refer to it here is a website from a holder of healthcare information who offers access to this website for individuals to retrieve their health information. Further, this provider has enabled their portal with a Blue Button capability, meaning a patient can login to the patient portal, navigate to the appropriate page, and then download their Blue Button record.

To date, iBlueButton supports Blue-Button enabled portals: (1) My HealtheVet from the Veterans Administration, (2) MyMedicare from CMS and (3) TRICARE Online for active-duty military.

If you have an account at any of these data holders, then simply tap on the portal’s name and enter your credentials (username and password)you have set to access the portal. Once you do this, the app will be ready to access and download your Blue Button record from that portal right down to the app (see the section “Acquiring Blue Button and Other Medical Records” for details on how to do this).

Can I Add in Portal Credentials Later (Instead of During My First Time Use)?

Yes, simply tap a profile, then tap Settings in the lower-right corner, then tap “Medical Record Portals”.

What Is a DIRECT Address?

A DIRECT Address is used to securely receive health records from healthcare providers, including from EMR (electronic medical record) systems used by most provider and hospitals, and their patient portals. To receive medical records from doctors or hospitals which have DIRECT Address-compliant systems, you will need to either give providers your DIRECT Address, or enter it into the provider’s patient portal. The iBlueButton automatically creates a unique DIRECT Address for each Profile you create. To do this, tap “Create New DIRECT Address” from this screen and the app will create a unique DIRECT Address for this Profile.

For additional information on DIRECT Addresses, see other Direct-Address questions throughout this document.

What is “Recover Existing DIRECT Address” For?

This is used if you are using iBlueButton on more than one device (e.g., an iPhone and an iPad), and you have previously created a DIRECT Address from another device for a given profile. In this instance, tap this recover option and enter in your previously-created DIRECT Address. When you do this, you will need to enter in the four-digit PIN you were given when you created this DIRECT Address.

What is the PIN Associated with a DIRECT Address?

When you create a new DIRECT Address, you are then taken to a screen that displays the unique DIRECT Address for the profile, and also creates a unique four-digit PIN that is used to recover this profile’s DIRECT Address from another device in the future (see above under “Recover Existing DIRECT Address”). This PIN is used for security, and is required to recover a DIRECT Address.

How Do I Recover My PIN If I Forget It?

Since it is an important security measure in recovering a DIRECT Address, you cannot get your PIN back in case you forget or lose it. RECOMMENDATION: When the app first creates a DIRECT Address and you are presented with the screen that reports your PIN, capture the screen and save it to your camera roll.

Creating Multiple Profiles[top]

Can I Create Additional Profiles?

Yes, you can create an unlimited number of patient profiles with iBlueButton.

How Do I Create Additional Profiles?

After you launch the app and tap Continue on the Welcome screen, you are taken to the Profiles screen. Tap “Add Profile” to add another profile. This will walk you through a similar set of steps that you did during your first use (core profile screen, portals-screen, and Direct-Address creation/recovery screen).

Who Should I Create Profiles For?

Create Profiles for any person who you may care for, including those for whom you are an authorized healthcare proxy. In a typical example, a mother may create profile for herself, her husband, her children, her parents, and any other people who she may care for.

Acquiring Records from Blue Button Portals[top]

How Do I Download a Blue Button Record from a Blue Button Enabled Portal?

After you have set credentials for a given portal within a Profile, then that portal will appear as an option when you tap down on the portal’s name from the Profile, just below the Summary Record. Simply tap that portal, and then tap, “Download from Portal”. The iBlueButton app will then automatically access and retrieve your Blue Button record from this portal.

To view a previously downloaded Blue Button record, tap the portal name and select “View Record”.

What Portals Does the App Support?

To date, iBlueButton supports these Blue-Button enabled portals: (1) My HealtheVet from the Veterans Administration, (2) MyMedicare from CMS and TRICARE Online for active-duty military.

Why the App Doesn’t Support More Portals?

Very few health record data holders have adopted the type of open standards allowing apps like iBlueButton to pull or receive health records. That is why iBlueButton only supports these Blue Button enabled portals at this time.

Starting in 2014, physician and hospital electronic Medical Record (EMR) systems have now embedded the DIRECT transmission protocol that will allow apps to receive Blue Button and other medical records, and this is why Humetrix has put so much effort implementing DIRECT Addresses into the latest version of iBlueButton.

What Should I Tell to My NOT-Supported Doctor or Hospital?

Ask them if they, or their EMR (electronic medical records) vendor, have implemented the DIRECT Address protocol for the secure exchange of medical records. If they did, ask them to make use of the functionality, and if they haven’t, then tell them they should! For more on DIRECT Addresses, see sections and questions throughout this FAQ.

The Blue Button Download From One of the Blue Button Enabled Portals Isn’t Working; What Are Some Common Causes of This?

Here are the most common causes of Blue Button record download failures and how to fix them:

The MyMedicare Blue Button Record[top]

Why Does The MyMedicare Blue Button Record Display in a Pretty Dashboard?

In response to federally-sponsored industry challenge, in 2012 (U.S. Department of Health and Human Services Investing in Innovation Blue Button competition), Humetrix introduced a significantly-improved, interactive display for the Medicare Blue Button record that we call the MyMedicare Blue Button Dashboard.” If you are a Medicare beneficiary and download your MyMedicare Blue Button record using an iBlueButton phone app, then you will enjoy this interactive display when you tap down on your MyMedicare Blue Button record. There are a lot of features in this display, including some “behind-the-scenes” app features that warrant the following additional detail –

Acquiring Records using a DIRECT Address[top]

How Do I Get Records into iBlueButton Using My DIRECT Address?

When you see a provider and you find out that they are using new EMRs which are Direct enabled, just give them your DIRECT Address and tell them to send you your medical record(s) via Direct.

When they send/transmit you a record, you will receive a push notification that the record has arrived. Swipe over on that push notification and iBlueButton will open and take you to the record that was received.

Some provider patient portals also allow you to enter your DIRECT Address into the portal, and then send yourself (to your DIRECT Address) medical records available from that provider.

Note that each profile you create will have its own unique DIRECT Address, so be sure to use the correct one for the records you want to receive.

My Doctor Sent Me a Record To My DIRECT Address But I Didn’t Receive It; Why?

Please double check your DIRECT Address with your Doctor, ensure that it is correct, and ask them to send you the record again.

If this doesn’t fix it, then the most likely scenario is that your provider has not yet applied all the rules required to transmit records to their patients.

How Do I Recover a DIRECT Address For a New Device?

When you set-up your profile on a new device, tap the “Recover existing DIRECT Address” when presented. You will need to know your input your first/last name and the PIN associated with your DIRECT Address.

I Already Have a DIRECT Address that I Received From a Different Provider; Can I Use This with iBlueButton?

No, you have to use the DIRECT Address created for you by iBlueButton to receive messages to iBlueButton.

I Entered My DIRECT Address Into My Patient Portal and Nothing Happened?

Entering in your DIRECT Address is just the first step. Ideally, your patient portal provider has implemented the ability to choose a medical record, and then send it to your DIRECT Address. It’s this ability to select a record and then send it that needs to happen before you will receive it into iBlueButton.

Can I Use an Email Client Like Outlook or the Apple Mail Client To Receive Direct-Address Messages?

No. The DIRECT Address protocol has a whole layer of backend infrastructure, security, and an approval process that is not available in off-the-shelf email clients. These are the measures put in place to ensure that the DIRECT Address protocol is secure and appropriate for exchanging medical records.

Other ways to get Records into the App[top]

How Else Can I Get Other Medical Records Into the App?

There are three primary ways to add other health records to iBlueButton: (1) with the Photo/Camera feature, (2) by transferring documents from other apps such as the Dropbox app into iBlueButton with the “Open In” feature. See below for more details.

The Summary Record[top]

What Is The Summary Record at the Top of a Profile?

• The iBlueButton app automatically creates a “Summary Record” from the downloaded Blue Button records you receive in your app, as well the standardized medical record summaries sent to you by your healthcare providers. Standardized records are health records that comply with structured format standards which meet federal regulations governing the use of EMRs by physicians and hospitals. This Summary Record includes a list of Conditions and Medications with convenient look-up of these Conditions and Medications from MedlinePlus, a service of the U.S. National Library of Medicine and the National Institute of Health, as well as summary tables for Allergies and Immunizations.

Can I Self-Enter Data Into the Summary Record?

Yes! We have made it easy and fast to self-enter Medications, Conditions, Allergies and Immunizations right into the Summary Record. Under each of these four categories, simply tap the encircled ‘+’ icon, and you will be presented with a scrollable pick-list where you can chose the item you want to add.

How Can I Learn More About Medications, Conditions, and Immunizations?

We have added convenient look-up to Medline Plus, a service of the U.S. National Library of Medicine and the National Institute of Health, directly in the iBlueButton app. Simply tap down on a given medication, condition, or immunization, and then two panels will get expanded below the selected item. In the second panel, swipe to the right until you get the “Medline Plus” logo. Tap that logo and you will be taken to the official informational entry for that item.

What Are The Currently Taking / Currently Experiencing Panels?

Under Medications, if you select a medication, you can indicate if you are currently taking it. You can also indicate if you are experiencing any side effects.

Under Conditions, you can similarly indicate if you are currently experiencing the condition, and also indicate if the condition was reported in error (if it came from a Blue Button or other medical record download).

Medications or conditions which are no longer taken or experience will then be moved out of the Current section into the Past section.

You can then share these annotations with your provider at the point of care.

What does the Privacy Warning Annotation Let Me Do?

The iBlueButton app lets you mask portions of your Summary Record in annotating information with a privacy check mark (shown as a padlock symbol). Data marked this way will not be included in the printed Summary Record or shared with providers.

Why Don’t All of My Medications, Conditions, Allergies and Immunizations Show Up In My Summary Record from Blue Button and Other Medical Records that I Receive?

Some records that we download and receive into the app are not in a format that the iBlueButton app can parse and understand, and in these situations, we are not able to process and add this information to the Summary Record. In these cases, we recommend self-entering this data.

How Can I Synchronize My Profile and Medical Records to Other Devices?

We currently do not support this but are considering this feature for a later release.

Can I Also Share My Health Records via Email?

Yes, as a convenience to our users, we support emailing Blue Button and health records via our email feature, accessed within a profile by tapping on a record and then selecting “Email Record”. We display a privacy warning when this feature is selected as a reminder that email is not a secure way to transfer medical information.

Privacy and Security[top]

Where is the App’s Privacy Policy?

Our Privacy Policy is located off of the About screen in the app. The About is accessible from the lower-right-hand corner of the Profiles screen.

Does the App Share my PHI (Protected Health Information) with Any Other Entities Other Than Those Providers Who I Directly Share my Data With?

Absolutely not.

Keeping Private Portions of my Summary Record

The iBlueButton app lets you mask portions of your Summary Record in annotating information with a privacy check mark (shown as a padlock symbol). Data marked this way will not be included in the printed Summary Record or shared with providers.

What Security Measures Are Present In the App?

We take security very seriously. So seriously, in fact, that this will be a long, and sometimes technical answer. Here we go –

1. Access and Authorization
iBlueButton implements and recommends the following access-and-authorization security measures:

2. Encryption and Technical Security
All data stored across the iBlueButton apps are AES-256 encrypted using a random key. When any two iBlueButton apps exchange data, encryption keys are embedded in the QR code used to exchange data between the sending and receiving devices. We encrypt the data to be transferred using AES-256. When complete, we throw away the shared secret and redo the entire process the next time we need to do an exchange. This means that every data transfer is unique and secure from every other data transfer.

3. Built in Security Warnings
Throughout the iBlueButton apps, anytime that protected health information (PHI) is exchanged or exported from the app in any way, we display a Privacy Warning that the user must take action on via the tap of an Okay button. We worked with health privacy and patient-advocacy leaders in drafting our privacy warnings, and continue to work with these individuals as our iBlueButton app platform evolves.

As a convenience feature, our iBlueButton apps do offer the ability to email Blue Button records and other PHI out of a given app. This, however, is under users’ control and they must confirm through a privacy warning before doing so.

iBlueButton for Android[top]

Is iBlueButton available for Android?

Yes, iBlueButton is available for Android, and its version number matches the version numbers we maintain for the iOS / Apple version of iBlueButton.

Are the features of iBlueButton Android the same as iBlueButton for iOS / Apple?

Yes, all features should work the same between both versions.

What Android devices and operating systems are supported?

Recommended devices are ones released over the last 18 months running contemporary versions of the Android operating-system. For example, recent Samsung releases are typically good choices.

Regarding device specifics, what is the minimum screen resolution and memory requirements?

We strongly suggest a minimum screen resolution of 480x800 and memory of 500mbs.

How will I know when an update to the app is available?

If you have setup to automatically update the apps you will just get the update. Otherwise you will have to manually install the update. If you have missed the notification, you can get the update by navigating to My Apps under the menu in the Playstore app.

Spread the Word[top]

How can I Tell Others About iBlueButton?

Tell all your friends, family and colleagues about the Blue Button initiative and Humetrix’ iBlueButton apps. Direct links to all of our iBlueButton apps are available on our website at

What Other Apps Does Humetrix Make?

Humetrix makes an award-winning "In Case of Emergency" app SOS-QR as well as an app to manage your Blood Pressure TENSIO