Back to UniFi Protect Guides
UniFi Protect

How to Fix UniFi Protect Smart Detection Not Triggering on People

UniFi Protect GuideSecurity Cameras
medium difficulty 15-20 minutes 132 views 0 found helpful Where this fix applies: Global Updated
This guide applies to: UniFi Protect UniFi Person Detection Gaps (Protect person smart detection tuning)
At a glance — most common causes
  • smart detection zone mismatch
  • sensitivity threshold too strict
  • camera scene framing not optimized
15-20 minutes8 solutions coveredmedium level

Expert Review & Technical Scope

DeviceUniFi Protect UniFi Person Detection Gaps
Model CoverageProtect person smart detection tuning
Fix Time15-20 minutes
DifficultyMedium
Required Toolssmart detection settings, event timeline
Network / ProtocolWi-Fi / app-based troubleshooting context

Problem Description

UniFi Protect's smart detection does not trigger on people — motion events fire but no 'Person' tag appears, so person-specific notifications and automations do not work. Smart detections must be enabled per camera, the camera must be a G4/G5 model, the camera angle must show people clearly, the NVR must have processing capacity, and the AI model must be current.

Why This Happens in Real Homes

Why this happens in real homes usually comes down to environment and timing, not instant hardware failure. Person events are visible in footage but smart detections do not trigger. The pattern people actually report is No person detection tags, motion only events, and detections inconsistent by angle

The most common real-world triggers are smart detection zone mismatch, sensitivity threshold too strict, and camera scene framing not optimized. The fix is most reliable when the sequence is followed exactly: Replay missed person events, then Tune classifier sensitivity, then Validate with controlled walk tests. After the repair, run multiple command and automation checks so the issue does not reappear later in the day.

Symptoms

  • No person detection tags
  • motion only events
  • detections inconsistent by angle

Recognize these? Here's what usually causes it.

Common Causes

  • smart detection zone mismatch
  • sensitivity threshold too strict
  • camera scene framing not optimized

Most fixes happen in the first 3 steps.

Warning

Do not rely on generic default zones for all camera positions.

Tools & Requirements

smart detection settingsevent timeline

Step-by-Step Solution

1

Verify smart detections are enabled for the camera

In Protect: Devices > select camera > Settings > Smart Detections. Enable 'Person' detection. Not all cameras support smart detections — only G4 and G5 series cameras have the required AI processing. Older G3 cameras do not support smart detections. If the smart detection toggles are grayed out: the camera model does not support it. After enabling: walk in front of the camera and check the Events page for a 'Person' event tag (distinct from a plain 'Motion' event).

2

Check camera placement and angle for person detection

The smart detection model works best when people are clearly visible — upright, at least 3 feet tall in frame, and not heavily occluded. Cameras mounted very high (20+ feet) looking straight down: people appear as small overhead blobs that the model cannot classify. Cameras at eye level (6-8 feet) with a slight downward angle: people are clearly recognizable. If detection misses people: lower the camera or adjust the tilt angle. Also check at night: if the IR illumination is weak, people may be too dark for the AI model to classify.

3

Adjust smart detection sensitivity

In Protect: Devices > camera > Smart Detections > Person Sensitivity (if available in your Protect version). If sensitivity is too low: only close, well-lit, clearly visible people trigger smart detection. Increase sensitivity for cameras where people are at medium range or in mixed lighting. Note: higher sensitivity may also increase false positives (detecting people in shadows, reflections, or similar shapes). Monitor the Events page for false 'Person' detections after increasing sensitivity.

4

Check NVR processing capacity for smart detections

Smart detections require significant processing power on the NVR. The Cloud Key Gen2+ can handle smart detections for about 5-7 cameras. The UDMP handles 15-20 cameras. The UNVR handles 20+ cameras with dedicated AI processing. If the NVR is overloaded: smart detections are delayed or skipped entirely. Check UniFi OS CPU usage: if consistently above 85%: reduce the number of cameras with smart detection enabled, or upgrade to a more powerful NVR.

5

Update Protect and camera firmware for AI model improvements

Ubiquiti frequently updates the smart detection AI model with improved accuracy. Each Protect update may include a new model that detects people more reliably in challenging conditions (night, rain, partial occlusion). Update Protect: UniFi OS > Updates. Update camera firmware: Protect > Devices > each camera > check for updates. After updating: allow 24-48 hours for the new model to process and calibrate. Smart detection accuracy typically improves noticeably with each major Protect version update.

Quick Solutions

redefine person detection zones
tune thresholds for scene
adjust camera angle/framing for classifier

Still having issues? This is usually the deeper cause below.

If the sensor still misses events after repositioning, check whether a scheduled 'home' or 'away' mode is overriding the sensitivity setting silently.

Pro Tip

Smart detection quality depends on both zone design and scene framing.

Real-World Insight

This issue almost always looks more complex than it is — the majority of cases trace back to a single setting, a stale credential, or a default that shipped wrong.

What Usually Goes Wrong
  • smart detection zone mismatch
  • sensitivity threshold too strict
  • camera scene framing not optimized

Official Manufacturer Manual

UniFi Protect provides official product documentation through their online manual rather than downloadable PDF. Access setup guides, troubleshooting steps, and product specifications for your UniFi Person Detection Gaps.

View UniFi Person Detection Gaps Online Manual

Source: help.ui.com

Need More Help? UniFi Protect Support

Note: The contact information below connects you directly to UniFi Protect's official customer support team, not Trunetto. They can help with warranty claims, device replacements, and advanced technical issues.