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

# Record Patient Measurements

> Record, review, and edit patient measurements from the patient chart, forms, and notes.

<Info>
  **Prerequisites:** Configure custom [measurement fields and groups](/modules/settings/measurements) before recording measurements that are not already set up.
</Info>

Measurements track patient values over time, such as vitals, body composition, lab results, range of motion, or assessment scores.

## Where measurements appear

Open a patient chart to view measurements in two places:

* **Overview** — the **Measurements** section shows the latest values in each group.
* **Medical Notes & Data** — the **Measurements** section gives more room for tables, charts, goals, and editing.

If a value is recorded for a field that is not in a group, it appears under **Other Measurements**. If **Show Measurements** is enabled in **Settings > Patient Portal**, patients can also see measurements in the patient portal.

## Record measurements from a patient chart

<Steps>
  <Step title="Open the patient chart">
    Open the patient and go to **Overview** or **Medical Notes & Data**.
  </Step>

  <Step title="Start a measurement entry">
    In **Measurements**, click **Add**.
  </Step>

  <Step title="Choose what to record">
    In **Add Measurements**, select a measurement group or open **Individual Fields** and choose one field.
  </Step>

  <Step title="Enter the measurement date">
    Set **Measurement Date** to the date the values were taken.
  </Step>

  <Step title="Enter values">
    Fill in the fields you want to record. Required fields are marked with an asterisk.
  </Step>

  <Step title="Save">
    Click **Save**. The values appear in **Measurements** on the patient chart.
  </Step>
</Steps>

If a field already has a value on the selected date, Decoda shows **Last:** with the existing value. Leave **Keep existing** selected to avoid adding another value, or switch to **Record new** to save a new entry.

## Review trends and goals

Each measurement group can be viewed as **Table**, **Cards**, or **Chart**. The available view depends on how the group was configured in **Settings > Measurements**.

In the **Table** view, a date row that contains more than one set of values shows an expand chevron. Click it to see each individual entry, with its own time, listed under that date.

If the same field belongs to more than one group, Decoda shows one chart pill for that field instead of repeating it. Use the pill to show or hide the field in the chart.

Some calculated scores show a **Score donut** chart. The ring shows the parts of the score, their weight, and how much each part contributed.

A calculated value may show a **Warning** label. Open the warning to see why it appears. For example, Decoda may have used an earlier value because the current measurement date was missing one of the needed fields.

For numeric fields, use **Set Goal** or **Edit Goal** to track a target. Goals can appear on cards, tables, and charts. Calculated goals may appear automatically when Decoda can calculate them from related field goals.

To change a recorded value, use **Edit Value** on that entry. Calculated values cannot be edited directly; update the values they are based on instead.

## Values from forms and notes

Measurements can also come from forms and clinical notes:

* A form that includes **Measurements** or **Measurement Groups** saves those answers to the patient chart when the patient submits the form.
* A note template that includes **Measurements** or **Measurement Groups** saves those answers to the patient chart when the provider clicks **Save**.
* An AI Scribe note can fill measurement fields from the visit conversation. Review the values before clicking **Save**.

These values appear in the same **Measurements** sections as values entered directly from the patient chart. Values submitted by patients through a form show a **Patient** or **Patient reported** label in measurement tables, cards, patient portal widgets, and chart details. Values recorded by staff or saved from provider notes do not show this label.

## What can be recorded

Measurement fields can collect:

* Numbers, such as weight, pulse, or A1C.
* Text, such as a clinical score label.
* One choice from a fixed list.
* Multiple values from a list or typed in by staff.

Calculated fields, such as BMI, BMR, and custom scores, are filled in by Decoda after the needed values exist. A calculated score may combine several related measurements. Lower section scores can help point staff to the area that needs review.

## Related pages

* [Measurements Settings](/modules/settings/measurements)
* [Patient Chart](/modules/patients/patient-chart)
* [Forms](/modules/forms)
* [Note Templates](/modules/settings/note-templates)