{
    "api_version": "1",
    "kind": "dse_post",
    "self": "https://update.dsesecurity.com/api/v1/posts/preserve-card-format-meaning-when-configuring-a-unifi-retrofit-hub/",
    "item": {
        "id": "https://update.dsesecurity.com/updates/preserve-card-format-meaning-when-configuring-a-unifi-retrofit-hub/",
        "slug": "preserve-card-format-meaning-when-configuring-a-unifi-retrofit-hub",
        "url": "https://update.dsesecurity.com/updates/preserve-card-format-meaning-when-configuring-a-unifi-retrofit-hub/",
        "alternate_urls": {
            "markdown": "https://update.dsesecurity.com/updates/preserve-card-format-meaning-when-configuring-a-unifi-retrofit-hub.md",
            "json": "https://update.dsesecurity.com/api/v1/posts/preserve-card-format-meaning-when-configuring-a-unifi-retrofit-hub/"
        },
        "title": "Preserve card-format meaning when configuring a UniFi Retrofit Hub",
        "summary": "Pilot the complete credential format and promised mobile features before approving a wiring-reuse migration.",
        "format": {
            "slug": "guide",
            "name": "Guide"
        },
        "priority": {
            "slug": "info",
            "name": "Information"
        },
        "featured": false,
        "image": {
            "theme": "physical-security",
            "label": "Physical security",
            "alt": "Integrated video surveillance and controlled entry at a modern commercial facility.",
            "card_url": "https://update.dsesecurity.com/assets/editorial/physical-security-card.webp?v=1.8.20",
            "hero_url": "https://update.dsesecurity.com/assets/editorial/physical-security-hero.webp?v=1.8.20",
            "social_url": "https://update.dsesecurity.com/assets/editorial/physical-security-social-v2.jpg?v=1.8.20",
            "width": 2400,
            "height": 1350
        },
        "topics": [
            {
                "slug": "access-control",
                "name": "Access Control",
                "url": "https://update.dsesecurity.com/topic/access-control/"
            }
        ],
        "author": {
            "name": "DSE Security Editorial Team",
            "url": "https://update.dsesecurity.com/#editorial-team",
            "type": "Organization"
        },
        "publisher": {
            "name": "Detection Systems & Engineering",
            "url": "https://dsesecurity.com/"
        },
        "published_at": "2026-10-15T13:32:13+00:00",
        "modified_at": "2026-10-15T13:36:14+00:00",
        "reviewed_on": "2026-10-15",
        "reading_minutes": 2,
        "word_count": 278,
        "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.",
        "primary_source": {
            "name": "Ubiquiti Help Center — Configuring the UniFi Retrofit Hub in UniFi Access",
            "url": "https://help.ui.com/hc/en-us/articles/34338807702679-Configuring-the-UniFi-Retrofit-Hub-in-UniFi-Access",
            "published_on": null,
            "authority": "help.ui.com"
        },
        "publishing_principles": "https://update.dsesecurity.com/updates/dse-updates-editorial-methodology/",
        "usage_info": "https://update.dsesecurity.com/usage/",
        "copyright_notice": "Copyright © 2026 Detection Systems & Engineering. All rights reserved.",
        "content_html": "<p>Pilot the complete credential format and promised mobile features before approving a wiring-reuse migration.</p>\n<h2>Source facts</h2>\n<p>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.</p>\n<p>Source: <a href=\"https://help.ui.com/hc/en-us/articles/34338807702679-Configuring-the-UniFi-Retrofit-Hub-in-UniFi-Access\">Ubiquiti Help Center — Configuring the UniFi Retrofit Hub in UniFi Access</a>.</p>\n<h2>Applicability</h2>\n<p>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.</p>\n<h2>DSE recommendation</h2>\n<p>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.</p>\n<h2>Verification</h2>\n<p>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.</p>\n<h2>Official reference</h2>\n<p><a href=\"https://help.ui.com/hc/en-us/articles/34338807702679-Configuring-the-UniFi-Retrofit-Hub-in-UniFi-Access\">Ubiquiti Help Center — Configuring the UniFi Retrofit Hub in UniFi Access</a>. Reviewed October 15, 2026.</p>",
        "content_text": "Pilot the complete credential format and promised mobile features before approving a wiring-reuse migration.\nSource facts\nThe 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.\nSource: Ubiquiti Help Center — Configuring the UniFi Retrofit Hub in UniFi Access.\nApplicability\nApplies 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.\nDSE recommendation\nDSE 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.\nVerification\nOn 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.\nOfficial reference\nUbiquiti Help Center — Configuring the UniFi Retrofit Hub in UniFi Access. Reviewed October 15, 2026.",
        "content_markdown": "Pilot the complete credential format and promised mobile features before approving a wiring-reuse migration.\n\n## Source facts\n\nThe 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.\n\nSource: [Ubiquiti Help Center — Configuring the UniFi Retrofit Hub in UniFi Access](https://help.ui.com/hc/en-us/articles/34338807702679-Configuring-the-UniFi-Retrofit-Hub-in-UniFi-Access).\n\n## Applicability\n\nApplies 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.\n\n## DSE recommendation\n\nDSE 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.\n\n## Verification\n\nOn 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.\n\n## Official reference\n\n[Ubiquiti Help Center — Configuring the UniFi Retrofit Hub in UniFi Access](https://help.ui.com/hc/en-us/articles/34338807702679-Configuring-the-UniFi-Retrofit-Hub-in-UniFi-Access). Reviewed October 15, 2026."
    },
    "json_ld": {
        "@context": "https://schema.org",
        "@graph": [
            {
                "@type": "Organization",
                "@id": "https://dsesecurity.com/#organization",
                "name": "Detection Systems & Engineering",
                "alternateName": "DSE Security",
                "url": "https://dsesecurity.com/",
                "logo": {
                    "@type": "ImageObject",
                    "url": "https://update.dsesecurity.com/assets/dse-logo-20260812.png?v=1.8.20"
                }
            },
            {
                "@type": "Organization",
                "@id": "https://update.dsesecurity.com/#editorial-team",
                "name": "DSE Security Editorial Team",
                "url": "https://update.dsesecurity.com/",
                "parentOrganization": {
                    "@id": "https://dsesecurity.com/#organization"
                }
            },
            {
                "@type": "WebSite",
                "@id": "https://update.dsesecurity.com/#website",
                "name": "DSE Updates",
                "alternateName": "DSE Security Knowledge Hub",
                "url": "https://update.dsesecurity.com/",
                "inLanguage": "en-US",
                "publisher": {
                    "@id": "https://dsesecurity.com/#organization"
                },
                "potentialAction": {
                    "@type": "SearchAction",
                    "target": {
                        "@type": "EntryPoint",
                        "urlTemplate": "https://update.dsesecurity.com/?q={search_term_string}"
                    },
                    "query-input": "required name=search_term_string"
                }
            },
            {
                "@type": "WebPage",
                "@id": "https://update.dsesecurity.com/updates/preserve-card-format-meaning-when-configuring-a-unifi-retrofit-hub/",
                "url": "https://update.dsesecurity.com/updates/preserve-card-format-meaning-when-configuring-a-unifi-retrofit-hub/",
                "isPartOf": {
                    "@id": "https://update.dsesecurity.com/#website"
                },
                "lastReviewed": "2026-10-15"
            },
            {
                "@type": "BreadcrumbList",
                "@id": "https://update.dsesecurity.com/updates/preserve-card-format-meaning-when-configuring-a-unifi-retrofit-hub/#breadcrumbs",
                "itemListElement": [
                    {
                        "@type": "ListItem",
                        "position": 1,
                        "name": "DSE Updates",
                        "item": "https://update.dsesecurity.com/"
                    },
                    {
                        "@type": "ListItem",
                        "position": 2,
                        "name": "Preserve card-format meaning when configuring a UniFi Retrofit Hub",
                        "item": "https://update.dsesecurity.com/updates/preserve-card-format-meaning-when-configuring-a-unifi-retrofit-hub/"
                    }
                ]
            },
            {
                "@type": [
                    "Article",
                    "TechArticle"
                ],
                "@id": "https://update.dsesecurity.com/updates/preserve-card-format-meaning-when-configuring-a-unifi-retrofit-hub/#article",
                "identifier": "https://update.dsesecurity.com/updates/preserve-card-format-meaning-when-configuring-a-unifi-retrofit-hub/",
                "url": "https://update.dsesecurity.com/updates/preserve-card-format-meaning-when-configuring-a-unifi-retrofit-hub/",
                "headline": "Preserve card-format meaning when configuring a UniFi Retrofit Hub",
                "description": "Pilot the complete credential format and promised mobile features before approving a wiring-reuse migration.",
                "abstract": "Pilot the complete credential format and promised mobile features before approving a wiring-reuse migration.",
                "articleBody": "Pilot the complete credential format and promised mobile features before approving a wiring-reuse migration.\nSource facts\nThe 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.\nSource: Ubiquiti Help Center — Configuring the UniFi Retrofit Hub in UniFi Access.\nApplicability\nApplies 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.\nDSE recommendation\nDSE 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.\nVerification\nOn 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.\nOfficial reference\nUbiquiti Help Center — Configuring the UniFi Retrofit Hub in UniFi Access. Reviewed October 15, 2026.",
                "datePublished": "2026-10-15T13:32:13+00:00",
                "dateModified": "2026-10-15T13:36:14+00:00",
                "mainEntityOfPage": {
                    "@id": "https://update.dsesecurity.com/updates/preserve-card-format-meaning-when-configuring-a-unifi-retrofit-hub/"
                },
                "inLanguage": "en-US",
                "isAccessibleForFree": true,
                "author": {
                    "@type": "Organization",
                    "name": "DSE Security Editorial Team",
                    "url": "https://update.dsesecurity.com/#editorial-team"
                },
                "publisher": {
                    "@id": "https://dsesecurity.com/#organization"
                },
                "image": {
                    "@type": "ImageObject",
                    "@id": "https://update.dsesecurity.com/updates/preserve-card-format-meaning-when-configuring-a-unifi-retrofit-hub/#primaryimage",
                    "url": "https://update.dsesecurity.com/assets/editorial/physical-security-social-v2.jpg?v=1.8.20",
                    "contentUrl": "https://update.dsesecurity.com/assets/editorial/physical-security-social-v2.jpg?v=1.8.20",
                    "width": 1200,
                    "height": 630,
                    "caption": "Preserve card-format meaning when configuring a UniFi Retrofit Hub"
                },
                "articleSection": [
                    "Access Control"
                ],
                "keywords": [
                    "Access Control",
                    "Guide",
                    "Information priority"
                ],
                "genre": "Guide",
                "about": [
                    {
                        "@type": "Thing",
                        "name": "Access Control",
                        "url": "https://update.dsesecurity.com/topic/access-control/"
                    }
                ],
                "wordCount": 278,
                "timeRequired": "PT2M",
                "publishingPrinciples": "https://update.dsesecurity.com/updates/dse-updates-editorial-methodology/",
                "usageInfo": "https://update.dsesecurity.com/usage/",
                "copyrightHolder": {
                    "@id": "https://dsesecurity.com/#organization"
                },
                "copyrightNotice": "Copyright © 2026 Detection Systems & Engineering. All rights reserved.",
                "citation": {
                    "@type": "CreativeWork",
                    "name": "Ubiquiti Help Center — Configuring the UniFi Retrofit Hub in UniFi Access",
                    "url": "https://help.ui.com/hc/en-us/articles/34338807702679-Configuring-the-UniFi-Retrofit-Hub-in-UniFi-Access"
                }
            }
        ]
    }
}