Reference
The quick-lookup page: every option, default, and limit, with links to the page that explains it.
Feature requirements
Details: Overview · Getting started
| Requirement | Value |
|---|---|
| Module prerequisite | CCTV module (which requires Device Management) |
| Facility features | People (core) · AI Insights (enhanced background analysis) |
| Per-camera prerequisite | People Tracking enabled |
| Self Learning prerequisite | Enhanced AI Analysis on (CCTV Settings → General) |
| Feature-off API response | "People feature is not enabled for this facility" |
| Guest share tokens | No access to people or face-detection data |
| AI camera capacity | ~half of VSaaS-only capacity per appliance — see The hardware |
Member matching thresholds
Details: Face recognition tuning
| Setting | Lenient | Balanced (default) | Strict |
|---|---|---|---|
| Identified Match Threshold | 80 | 85 | 92 |
| Drop Threshold | 55 | 45 | 35 |
| Identified Collection Search Floor | 35 | 40 | 47 |
| Setting | Default |
|---|---|
| Visiting Member Bonus | +5 |
| Check-in Lookback Window | 30 mins |
| Borderline Confidence Zone (pose-check band) | +7 |
| Identified pose limits (yaw / pitch / roll) | 55° / 30° / 30° |
| Blacklist check | 95% — fixed, runs first, not configurable |
Shadow profile thresholds
Details: Face recognition tuning · How it works
| Setting | Default |
|---|---|
| Profile Link Threshold | 80 |
| Duplicate Prevention Threshold | 90 |
| Minimum Detection Confidence | 90 |
| Unidentified pose limits (yaw / pitch / roll) | 30° / 35° / 60° |
| Quality preset | Lenient / Balanced / Strict |
| Tier 1 — Fast Quality Checks | Sharpness · Contrast · Lighting · Exposure · Dynamic Range · Eye Aspect Ratio (~10–60 ms) |
| Tier 2 — ISO Quality Checks | Face Occlusion · Eyes · Mouth · Head Pose · Illumination · Exposure · Compression · Expression (~5–10 s) |
Self Learning parameters
Details: Self Learning · Face recognition tuning
| Parameter | Balanced default |
|---|---|
| Minimum correlated visits | 8 |
| Lookback period | ~2 months |
| Timing window around check-in | ±10 minutes |
| Gender check | On |
| Age check | Off (tolerance 10 years) |
| Candidate rule | Exactly one member candidate, or No match |
| Auto shadow photos | 99%+ similarity · max 6 per person · cooldown between additions |
Queue statuses: Pipeline · Pending Review · Automatically Linked · Unable to Link · No Match · Rejected · Manually Approved · Monitoring · Linking… · Link Failed.
Timeline
Details: People timeline · Settings → People Timeline
| Setting / limit | Value |
|---|---|
| Minimum Time to Merge Detections | 45 mins (default) |
| Minimum detections (threshold filter) | 3 (default) — filter tooltip cites "at least 5 detections and a duration of 5 minutes or more" |
| Minimum duration (threshold filter) | 5 mins (default) |
| Show No Check-In Badge | Off (default) |
| Day range options | 1D / 2D / 3D |
| Sort options | Last Seen (default) · Visit Time · Name · Visit Count |
| Bulk select limit | 100 people |
| Merge limit | 2–20 profiles per merge |
Classification chips: All · Facility Members · Current · EA Members · From Other Clubs · Unidentified · Unsure · Expired · On Hold · Card Sharing · Tailgating · Access Violators. (Most hide when their count is zero.)
People list
Details: People & profiles
| Control | Options |
|---|---|
| Quick tabs | All · Active · Expired · Staff |
| Photo Status filter | Valid Photo · Invalid Photo · Not Processed |
| Sort By | Recently Added (default) · Last Name (A-Z / Z-A) · First Name (A-Z / Z-A) · Membership Updated |
| Views | Grid · Compact grid · List |
| New-member badge | "Active [NEW]" — joined within 5 days |
| Import steps | Upload File → Map Fields → Preview & Import |
Synced fields: always — name, DOB, gender, profile photo, membership status, member type, plans, tags; optional — email, mobile phone, address, created, updated (email + mobile phone on by default).
Reports
Details: Reports
| Item | Value |
|---|---|
| Snapshot generation | Overnight, for the previous day (facility-local time) |
| KPIs | Total Tracks · Unique People · Avg Visit · Unsure % · Peak Hour · Access Violations |
| Heatmap modes | Tracks · Detections · People · Unsures |
| Heatmap display options | Peak Hour Heatmap · Cell Counts · Violations |
| Demographic age buckets | 18-24 · 25-34 · 35-44 · 45-54 · 55+ |
| Sentiment score range | 0–100 |
| Sentiment bands | Positive ≥ 70 · Neutral 40–69 · Negative < 40 |
| Sentiment presets | Default · Gym/Fitness · Custom |
Definitions: a track is "one continuous sighting of the same person"; total detections is "every face detected across all cameras"; an access violation is an entry "where a member's active membership plan was not permitted by the zone's access rules".
Access zones
Details: Access zones
| Item | Value |
|---|---|
| Zone badges | Anyone can access · Membership plan access · Restricted |
| Rule inputs | Membership plans · member types · tags (include or exclude) |
| Zone sources | Created locally · synced from member system (link/merge to combine) |
| Structure | Zones may nest — child cameras roll up to the parent |
| Sub-tabs | Camera Assignment · Membership Plans · Access Hours |
Data lifecycle
Details: Security & privacy
| Item | Value |
|---|---|
| Face collections per facility | Identified · Unidentified (shadow profiles) · Blacklist — isolated per facility |
| AI Metadata retention | Default 24 months, configurable — see Storage & retention |
| Shadow photos | Kept while the profile exists; excluded from time-based cleanup |
| Deletion paths | Delete this person (unidentified) · Delete Member (profile Advanced) · retention cleanup |
MCP tools
Details: Integrations & MCP
| Tool | Purpose |
|---|---|
insights_timeline_search | Search the detection timeline |
insights_people_search | Search registered people |
insights_person_get | One person's full profile |
insights_person_activity | A person's visit history |
insights_checkins | Member check-in history |
insights_match_unidentified | Correlate unidentified detections with check-ins |
insights_report_snapshots | Daily report snapshots |
All seven require CCTV module access + the People feature on the target facility.