UniFi - Guest Portal and Hotspot System


This article describes the difference between a Guest Network, the Guest Portal and the Hotspot system all found under the Guest Control section of the UniFi Controller.

Table of Contents

  1. UniFi Guest Networks vs. Guest Portal vs. Hotspot System
  2. Guest Portal Details
  3. Guest Portal Customization
  4. UniFi Hotspot System
  5. Related Articles

UniFi Guest Networks vs. Guest Portal vs. Hotspot System

Back to Top

Guest Users (Clients on Guest networks) will face different access restrictions from those faced by the trusted, "Corporate" Users on default UniFi networks. Guest Networks can therefore exist independently from the Guest Portal and/or Hotspot System, which are built-in tools for guest authentication, authorization & accounting. In other words—the Guest Portal is often/optionally applied to the Guest Network (for authentication), while the Guest Network is always enabled for users authenticating via the Guest Portal.

The Guest Portal is enabled under the Controller's Settings > Guest Control, and the Guest Portal adds an additional step for authentication of guest users attempting to access the network, including a series of different policies for guest network authentication.

Guest Portal Details

Back to Top

After establishing physical connectivity to the UniFi Switch—if wired, or a UniFi Access Point—if wireless, the guest device then proceeds to retrieve an IP address via DHCP to begin communicating on the network. Until the guest device is authenticated by the controller to access the network, UniFi devices will, by default, redirect all guest traffic to the UniFi Controller. At which point, the UniFi Controller serves the Guest Portal to the guest device, by means of a splash page, or landing page, with the following options for authentication:

  1. With Open Authentication selected, the guest need only accept a Terms & Conditions page to begin using the network.
  2. With Simple Password selected, the controller requires that the guest provide a password in order to begin using the network. This is a Layer-7 equivalent of requiring a passkey to associate with a WLAN, and inherently more useful since the UniFi Controller tracks guest authentication, under the Insights tab, as well as the Hotspot System.
  3. With Hotspot selected, UniFi supports Voucher & Payment-based authentication methods. While voucher creation is managed by the Hotspot System, UniFi also supports APIs to integrate the most popular Payment Merchants for each region.
  4. Finally, the External Portal option allows Admins to integrate their own Guest Portal into the UniFi system.

After successfully authenticating via the designated Authentication method, the guest is free to send traffic to the Internet during a user-defined period of time. Once the period of guest use expires, all guest traffic is once again re-directed to the UniFi Controller, pending re-authentication via the desired authentication method.

Overview of how guest users can authenticate via the UniFi Guest Portal server (optionally enabled in the UniFi Controller). 

Guest Portal Customization

Back to Top

UniFi offers two ways for full customization of the Guest Portal, whether via JavaServer Pages developed by a more proficient user, or the AngularJS engine, which anyone can use. The AngularJS engine is a powerful, built-in tool that makes customization easy, and straightforward through instant, graphic previews. See our UniFi - Wireless Guest Network Setup for more detailed instructions on customization.

UniFi's built-in AngularJS engine makes Guest Portal customization fast & easy.

UniFi Hotspot System

Back to Top

Intended as a separate guest management platform, the UniFi Hotspot System comes freely integrated in the UniFi Controller software. UniFi Controller admins and hotspot operators can access the Hotspot System via the GO TO HOTSPOT MANAGER link in Settings > Guest Control > Hotspot section. Users will be redirected to another area of the UniFi Controller for hotspot management exclusively.


Built separately from the UniFi Controller management system (device configuration/adoption sections), trusted employees can be granted limited-access Hotspot accounts to perform actions on Guest users, including:

  • Print vouchers
  • Manage guest authorization
  • Review payments
  • Check guest authentication, and more
Preview of UniFi Hotspot System where Operators can quickly create, customize & revoke vouchers for Internet access.

Related Articles

Back to Top

UniFi - Wireless Guest Network Setup

UniFi - Guest Portal Promotional URL Automatic Redirection

UniFi - Configuring the SELFRUN State

We're sorry to hear that!