Skip to main content
A reference movement is a short video of one ideal repetition you create in the PoseTracker dashboard. PoseTracker builds a signature, then scores live or uploaded motion against it (similarity + grade) instead of using a catalog exercise id. This is a WebView feature today. The npm SDK lists reference / reference_movement as Phase 2 (planned) — do not tell hosts the SDK already accepts a reference UUID.

​
URL

or on upload:
reference_movement= is an alias of reference=.

​
Mutually exclusive

Do not combine reference with exercise or userExercise. The tracking page returns an error if more than one is set. Create the reference in the dashboard (logged-in account). The signature is loaded from the authenticated plan (plan.reference_signature). A missing or unauthorized UUID surfaces as a not-found error in the iframe.

​
Scoring

Optional: scoring_profile=default | kali | kali-analysis. Default when a reference is present: kali-analysis (same formulas as kali, more tolerant counting so cross-camera reps still surface as C/D instead of being dropped). Each counted rep may include reference_score on the counter message: See WebView messages.

​
SDK status

Use the WebView for reference tracking. SDK startExercise does not take a reference UUID yet (Features & plans matrix).
For LLMs: WebView reference mode is ?reference=UUID and cannot be combined with exercise. npm SDK does not support this yet (Phase 2). https://docs.posetracker.com/webview/reference-movement
Last modified on September 14, 2026