What you need to know
Pilot the complete credential format and promised mobile features before approving a wiring-reuse migration.
Potentially affected
Applies to UA-Retrofit-Hub-2 and the compatible reader paths in the UniFi guide. Verify the actual installed reader and format; wiring reuse does not establish identical credential interpretation or feature support.
DSE recommendation
DSE recommends documenting the full credential format before replacing the controller.
Pilot the complete credential format and promised mobile features before approving a wiring-reuse migration.
Source facts
The UniFi Retrofit Hub supports compatible third-party Wiegand readers and UniFi Retrofit Readers, with model-specific unlock methods. When configuring a Wiegand reader, the selected card format must match the format emitted by the reader. The guide distinguishes raw data, formats containing a facility code and card number, and alternatives that omit the facility code. It also states that Touch Pass and Mobile Unlock require Retrofit Readers; retaining a Wiegand reader does not supply those reader-dependent capabilities.
Source: Ubiquiti Help Center — Configuring the UniFi Retrofit Hub in UniFi Access.
Applicability
Applies to UA-Retrofit-Hub-2 and the compatible reader paths in the UniFi guide. Verify the actual installed reader and format; wiring reuse does not establish identical credential interpretation or feature support.
DSE recommendation
DSE recommends documenting the full credential format before replacing the controller. Compare the reader’s emitted value with the intended identity representation and preserve facility-code meaning where the access design requires it. Pilot credentials from every relevant card population rather than one employee badge. List any expected mobile features against the actual reader type and resolve unsupported expectations before purchase. Have the access owner approve the migration mapping and retain the original configuration for rollback.
Verification
On an isolated or approved pilot door, compare controlled cards that exercise the relevant facility and card-number fields. Verify each maps to the correct person and that an unassigned test card is denied. Test any promised mobile function on the specific reader path, and record format settings from both ends.
Official reference
Ubiquiti Help Center — Configuring the UniFi Retrofit Hub in UniFi Access. Reviewed October 15, 2026.
Review the official source
Ubiquiti Help Center — Configuring the UniFi Retrofit Hub in UniFi Access · Verified October 15, 2026
Need help applying this guidance safely?
DSE can help confirm applicability, protect service continuity, and validate the result across physical security and IT systems.
Talk with DSE