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

# Adding a Patient's Family Health History

Air lets you record, change, and access a patient's **family health history** directly on their related-person records. This supports ONC Health IT certification criterion **§170.315(a)(12) Family Health History**, which requires that a user be able to capture a patient's family health history as coded data.

In Air, family health history is stored on a patient's **Related Persons** (for example, a parent, sibling, or grandparent). For each related person you can record one or more conditions, each tagged with an **ICD-10** code and a **clinical status**.

## Navigate to Family Health History

### <Icon icon="square-user" iconType="duotone" color="#F9345F" size={23} />  Open the patient's demographics

1. From the left navigation, open the **Patients** tab and search for the patient by name or MRN.
2. On the patient's profile, open the **Demographics** tab.

<img src="https://mintcdn.com/air_athelas/qwwuJAolxB0NMYh0/images/air_developer/onc_feature_guides/adding_family_health_history/adding_family_health_history_1.webp?fit=max&auto=format&n=qwwuJAolxB0NMYh0&q=85&s=ab99335d2c2d413887b68b3e4700c7dc" alt="Patient Demographics tab in Air showing General Information" width="1457" height="1590" data-path="images/air_developer/onc_feature_guides/adding_family_health_history/adding_family_health_history_1.webp" />

3. Scroll down to the **Responsible Parties** section. This section has two tabs: **Financially Responsible Parties** and **Related Persons**.
4. Select the **Related Persons** tab. Family health history is recorded against related persons, and the table includes a dedicated **Family Health History** column.

<img src="https://mintcdn.com/air_athelas/qwwuJAolxB0NMYh0/images/air_developer/onc_feature_guides/adding_family_health_history/adding_family_health_history_2.webp?fit=max&auto=format&n=qwwuJAolxB0NMYh0&q=85&s=bfcf76c65a5dbb98f2001cc2fb1e4f18" alt="Responsible Parties section with the Related Persons tab selected" width="1458" height="1071" data-path="images/air_developer/onc_feature_guides/adding_family_health_history/adding_family_health_history_2.webp" />

## Create a Family Health History

### <Icon icon="user-plus" iconType="duotone" color="#F9345F" size={23} />  Add a related person with health history

To record family health history, you first add the family member as a related person.

1. On the **Related Persons** tab, click the **+ Related Person** button.

<img src="https://mintcdn.com/air_athelas/qwwuJAolxB0NMYh0/images/air_developer/onc_feature_guides/adding_family_health_history/adding_family_health_history_3.webp?fit=max&auto=format&n=qwwuJAolxB0NMYh0&q=85&s=26fb150a81b396e9f9373e25df2f4ca2" alt="The Add Related Person button on the Related Persons tab" width="1183" height="457" data-path="images/air_developer/onc_feature_guides/adding_family_health_history/adding_family_health_history_3.webp" />

2. In the **Create Related Person** panel, enter the person's **First Name** and **Last Name**, choose their **Relationship** to the patient, and add their **Phone**, **Email**, and **Address** as needed.
3. Toggle on **Enable Health History**. This opens the **Family History Conditions** widget, where you record the related person's conditions.

<img src="https://mintcdn.com/air_athelas/qwwuJAolxB0NMYh0/images/air_developer/onc_feature_guides/adding_family_health_history/adding_family_health_history_4.webp?fit=max&auto=format&n=qwwuJAolxB0NMYh0&q=85&s=c9ca6f59510952b6c638073364c0c11f" alt="Create Related Person panel with the Enable Health History toggle" title="Create Related Person panel" style={{ width:"70%" }} width="1005" height="813" data-path="images/air_developer/onc_feature_guides/adding_family_health_history/adding_family_health_history_4.webp" />

4. In the **Family History Conditions** widget, select the condition in the **Family Health History (ICD-10)** field, then choose a **Clinical Status** for that condition. Click the **+** icon to add additional conditions for the same person.

<img src="https://mintcdn.com/air_athelas/qwwuJAolxB0NMYh0/images/air_developer/onc_feature_guides/adding_family_health_history/adding_family_health_history_5.webp?fit=max&auto=format&n=qwwuJAolxB0NMYh0&q=85&s=91c33eb76d6adab0307387837b479afb" alt="Clinical Status dropdown showing the six available statuses" title="Clinical Status options" style={{ width:"50%" }} width="413" height="416" data-path="images/air_developer/onc_feature_guides/adding_family_health_history/adding_family_health_history_5.webp" />

Each condition is assigned one of **6 clinical statuses**. Use the status that best describes the family member's current state for that condition:

| **Clinical Status** | **What it means**                                                                                         |
| :------------------ | :-------------------------------------------------------------------------------------------------------- |
| **Active**          | The condition is currently present and active for the family member.                                      |
| **Recurrence**      | The condition has returned after a prior period of remission or resolution.                               |
| **Relapse**         | The condition has returned after a period during which it was inactive.                                   |
| **Inactive**        | The condition is not currently active, but is being recorded as part of the history.                      |
| **Remission**       | The signs and symptoms are largely or fully absent, though the underlying condition may still be present. |
| **Resolved**        | The condition has fully resolved and is no longer present.                                                |

5. Click **Create Related Person** to save. The family health history is stored on the related person under **Responsible Parties**.

<Tip>
  ✨**Smart Tip:** Record each diagnosis as its own condition row so every entry carries its own ICD-10 code and clinical status. This keeps the patient's family history accurate and exportable as coded data.
</Tip>

## Edit a Family Health History

### <Icon icon="pen-to-square" iconType="duotone" color="#F9345F" size={23} />  Update an existing related person

To add or modify conditions for a family member you have already created:

1. On the **Related Persons** tab, click the **pencil** (edit) icon next to the person.

<img src="https://mintcdn.com/air_athelas/qwwuJAolxB0NMYh0/images/air_developer/onc_feature_guides/adding_family_health_history/adding_family_health_history_6.webp?fit=max&auto=format&n=qwwuJAolxB0NMYh0&q=85&s=64502ea4fbac2d2655339c16f566d522" alt="Pencil edit icon on a related person row" width="980" height="302" data-path="images/air_developer/onc_feature_guides/adding_family_health_history/adding_family_health_history_6.webp" />

2. In the **Edit Related Person** panel, make sure **Enable Health History** is toggled on, then use the **Family History Conditions** widget to add, change, or remove conditions—just as you did when creating the person.
3. To delete a condition, click the **X** to the right of that condition row.
4. Click **Update Related Person** to save your changes.

<img src="https://mintcdn.com/air_athelas/qwwuJAolxB0NMYh0/images/air_developer/onc_feature_guides/adding_family_health_history/adding_family_health_history_7.webp?fit=max&auto=format&n=qwwuJAolxB0NMYh0&q=85&s=df0fea6bcd2a570ae62956435931f708" alt="Edit Related Person panel with the Family History Conditions widget" title="Edit Related Person panel" style={{ width:"70%" }} width="1028" height="894" data-path="images/air_developer/onc_feature_guides/adding_family_health_history/adding_family_health_history_7.webp" />

### FAQ

<Accordion title="Where is a patient's family health history stored?">
  Family health history lives on the patient's **Related Persons**, found under **Demographics → Responsible Parties → Related Persons**. The table includes a **Family Health History** column so you can see at a glance which related persons have conditions recorded.
</Accordion>

<Accordion title="Can I record more than one condition for a single family member?">
  Yes. In the **Family History Conditions** widget, click the **+** icon to add another condition row. Each row has its own **Family Health History (ICD-10)** code and **Clinical Status**, so you can record as many conditions as needed for one person.
</Accordion>

<Accordion title="How do I remove a condition I added by mistake?">
  Click the **pencil** icon next to the related person to open the **Edit Related Person** panel, then click the **X** to the right of the condition you want to remove. Click **Update Related Person** to save.

  **Note:** Deleting a condition removes it from that related person's family history.
</Accordion>
