> ## 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.

# Tracked objects

> Set up 3D reference objects so the app knows what to track during a session.

Object tracking lets Holos Capture recognize and follow specific real-world objects during a session, recording their position over time alongside the other modalities.

## How it works

Objects are linked to a skill in the dashboard. When you start a session under that skill, the app prepares each linked object and tracks its position in real time throughout the recording.

Objects are linked to **Skills**, not individual captures. When a session is started under a skill, the app automatically prepares all objects associated with that skill.

## Setting up tracked objects

Tracked objects are managed in the Holos web dashboard, not in the Capture app itself.

1. Go to [Skills](https://app.holos.io/skills) in the Holos dashboard
2. Open the skill you want to configure
3. Under **Tracked objects**, click **Add object**
4. Select an object from the [object library](/dashboard/objects), or upload a new one
5. If the object isn't yet trackable, a processing request is filed automatically. The Holos team will process it and notify you when it's ready

Once objects are linked to a skill and their reference files are ready, they'll appear automatically the next time you start a capture under that skill.

## Object library

The Holos platform includes a library of CC0 objects and supports org-private uploads. Admins and managers can upload GLB, OBJ, FBX, or USDZ models via [Objects](https://app.holos.io/objects) in the dashboard.

<Note>Uploading objects requires admin or manager access.</Note> Uploaded models are automatically converted to the formats needed for web preview and AR tracking.

## During a session

When a tracked object is recognized:

* A highlight appears around it in your view
* Its position is recorded each frame for the duration of the session

If an object goes out of frame or is briefly occluded, the app will re-acquire it when it reappears. Tracking gaps are recorded as-is.