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

# Measuring

> Measure distances and heights on a capture's reconstructed environment, and share them with everyone who opens the capture.

![A capture's reconstructed environment with three measurements on a car: its length, the height of its rear wing and the gap to a column. The height is selected, showing who added it.](https://docs.holos.io/images/dashboard/capture-measuring-dark.png)

The capture viewer has a ruler for the room a capture was recorded in: bench and fixture heights, reach distances, aisle widths. Measurements are saved on the capture, so everyone in your organization who opens it sees the same ones, each marked with who added it.

The ruler is offered on captures that have a reconstructed environment. If a capture has none yet, build one from the **Environment** section of the properties panel first.

## Taking a measurement

Click the **ruler** button in the playback controls, beside the captions and inspector buttons. A toolbar opens over the scene with three ways to measure:

![The ruler toolbar with Height chosen and its hint: click a point to measure its height above the floor](https://docs.holos.io/images/dashboard/capture-ruler-toolbar-dark.png)

| Mode | What it measures | Use it for |
| - | - | - |
| **Distance** | A straight line between two points you click | Part sizes, gaps, clearances |
| **Height** | From a point straight down to the floor | Bench, sill and working heights |
| **Across** | Between two points along the floor, ignoring the difference in height | Reach distances, aisle widths |

* **Distance and Across** take two clicks: the start point, then the end point. A live line follows the pointer after the first click.
* **Height** takes one click. Hover over a surface and its height shows before you click.
* Hold **Shift** to keep a point on the floor, even when something is in the way.
* Press **Esc** to drop a measurement you have started.
* Dragging still turns the camera, so you can look around between the two clicks. Only a click without a drag places a point.

Click **Done** to close the ruler. Your measurements stay on screen.

## Units and precision

Lengths read in centimeters under a meter and in meters from a meter up ("87 cm", "1.25 m"). The **m** / **ft** button in the toolbar switches to feet and inches ("4 ft 1 in"). The choice is remembered in your browser.

The ruler measures on the environment's mesh, never on the photoreal splat, even when only the splat is showing. The mesh is built at a 3 cm resolution, so lengths are shown to the centimeter and no finer.

> [!NOTE]
>
> Captures recorded with the Holos Capture app on iPhone or Apple Vision Pro are measured to real scale by the device. A capture uploaded as a plain video has its scale estimated from the video instead, so its lengths read with a **\~** ("\~1.25 m"). Treat those as approximate.

## Who added what

Every measurement records the person who added it and when.

* **Select a label** in the scene to see "Added by" with the person's name, and a button to remove the measurement. Press **Delete** to remove the selected one.
* The **Measurements** section of the properties panel lists every measurement on the capture: what it reads, what kind it is, who added it and on what day.

![The Measurements section: a height, an across and a distance, each with who added it and the day](https://docs.holos.io/images/dashboard/capture-measurements-section-dark.png)

Anyone in the organization can add measurements to a capture they can open. Removing one is for the person who added it, the person who recorded the capture, or a manager, admin or owner.

## Showing and hiding measurements

The eye in the **Measurements** section header shows or hides every measurement in the scene. Hiding them only affects your view; they stay saved on the capture for everyone else.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.