Captive portal guides
Setup guides, design advice and vendor walkthroughs for the page guests see before they get online.
In short
A captive portal is the web page a guest sees before they get online on a public WiFi network. It asks them to accept terms, sign in with email, social or SMS, or enter a voucher, then tells the access point to let the device through. Purple runs its captive portal on the access points a venue already owns.
All 68 guides
Ruckus captive portal troubleshooting: WISPr redirect, hotspot and walled garden checklist
You will be able to diagnose a failing Ruckus captive portal from the symptom guests report, then fix it in a set order. The order covers the hotspot (WISPr) logon URL, walled garden, northbound portal interface password, RADIUS authentication and accounting, and HTTPS redirect certificates. The checks apply on SmartZone, Ruckus One and Unleashed.
10 min readUbiquiti UniFi captive portal troubleshooting: external portal, hotspot and walled garden checklist
Use this checklist to find out why your Ubiquiti UniFi captive portal is not working and fix it. You will match the symptom to one of six causes, run two quick tests, and correct the external portal server, pre-authorization access, guest subnet restrictions, HTTPS redirects, controller reachability or client settings.
10 min readHPE Aruba captive portal troubleshooting: redirect, certificate and walled garden checklist
Use this checklist to diagnose a failing HPE Aruba captive portal from the symptom you see: no redirect, a certificate warning or a guest who is never released. You can then trace the fault to DNS, DHCP, the walled garden, the redirect URL, the certificate or RADIUS. Finally, apply the fix on Instant APs, Aruba Central or a mobility controller.
9 min readCisco Meraki captive portal troubleshooting: splash page, walled garden and RADIUS checklist
Use this checklist to identify which of four faults is breaking your Cisco Meraki captive portal: splash page type, walled garden, grant URL hand-off or RADIUS reachability. You will be able to read the Meraki event log, match the symptom to its cause and apply the right fix without repeating SSID setup.
9 min readCaptive portal login on Android: a deployment checklist for Cisco Meraki, HPE Aruba and Ubiquiti UniFi
Use this checklist to get the Android sign-in notification appearing reliably on Cisco Meraki, HPE Aruba and Ubiquiti UniFi. You will scope a tight walled garden, block traffic until sign-on, secure the login page with HTTPS and keep DNS working. You will also choose a session timeout, decide on DHCP option 114 and trace each guest symptom to its fix.
14 min read
Ubiquiti UniFi guest portal not redirecting: causes and fixes
This guide isolates a UniFi guest portal redirect failure by following the guest state, redirect, pre-authorization route and controller authorization in sequence. It gives venue IT teams a sourced method to address guest-network versus Hotspot confusion, external portal hand-offs, current UniFi OS account requirements and DNS isolation testing.
12 min read
Cisco Meraki splash page not working: a troubleshooting flowchart
This practical day-two guide isolates where a Cisco Meraki splash flow has failed: client authorization, HTTP redirect initiation, walled-garden reachability or RADIUS sign-on. It gives venue IT teams a controlled evidence path, so they can restore Guest WiFi without making broad changes to a live estate.
12 min read
Enterprise Guest WiFi Setup Guide: VLAN Segmentation, Security, and Captive Portals
This technical guide shows IT teams how to set up Guest WiFi as a controlled internet-access service, using VLAN segmentation, firewall policy, and a captive portal. It also explains how Purple's registration forms and onboarding controls support a proportionate visitor experience without weakening the boundary around staff, payment, and operational systems.
12 min read
How to Set Up a Captive Portal on Starlink for Guest WiFi
This technical guide explains how to bypass Starlink's native CGNAT limitations to deploy a secure, CCPA/CPRA-compliant captive portal for guest WiFi. It covers the required architecture, VLAN segmentation, and bandwidth management strategies essential for remote venues, maritime operators, and event spaces.
4 min read
Captive Portals vs. Open Networks: Balancing Security and UX
This technical reference guide provides network architects and IT managers with a comprehensive blueprint for deploying guest WiFi networks. It analyzes the technical trade-offs between open networks and captive portals, detailing how to balance security protocols with user experience. Readers will learn how to configure resilient redirection mechanisms, manage MAC randomization, and implement seamless authentication workflows.
6 min read
Captive portal for Ruijie: set it up with Purple guest WiFi
How Purple's cloud guest WiFi sits on top of Ruijie RG Series access points using web authentication and RADIUS, configured from the command line, and where to find the exact setup steps.
2 min read
NETGEAR Enterprise AP and guest WiFi: captive portal setup with Purple
How NETGEAR Enterprise access points, managed through NETGEAR Insight, work with Purple guest WiFi: external web authentication, RADIUS and a walled garden, with a link to Purple's setup guide for the exact configuration.
2 min read
Huawei iMaster NCE (CloudCampus) and guest WiFi: captive portal setup with Purple
How Purple's cloud guest WiFi sits on top of Huawei AirEngine access points managed in iMaster NCE, using portal authentication and RADIUS relay, and where to find the exact setup steps.
2 min read
Cisco Catalyst WLC and guest WiFi: captive portal setup with Purple
How a Cisco Catalyst 9800 (IOS-XE) wireless LAN controller works with Purple guest WiFi: external web authentication, RADIUS and a walled garden, with a link to Purple's step-by-step setup guide for the exact configuration.
2 min read
WatchGuard WiFi Cloud AP and guest WiFi: captive portal setup with Purple
How WatchGuard WiFi Cloud access points, managed from WatchGuard Cloud, work with Purple guest WiFi: an external splash page with RADIUS authentication and a walled garden, with a link to Purple's step-by-step setup guide for the exact configuration.
2 min read
DrayTek Vigor and guest WiFi: captive portal setup with Purple
How DrayTek Vigor routers work with Purple guest WiFi: an external captive portal, RADIUS and a walled garden, with a link to Purple's step-by-step setup guide for the exact configuration.
2 min read
Mikrotik RouterOS and guest WiFi: captive portal setup with Purple
How Purple's cloud guest WiFi sits on top of MikroTik devices running RouterOS, using the built-in Hotspot and RADIUS, and where to find the exact setup steps.
2 min read
Captive portal for HPE Aruba: set it up with Purple guest WiFi
Setting up a guest captive portal on HPE Aruba Instant access points with Purple, using an external captive portal, RADIUS and an allowlist, through Aruba Central or the Virtual Controller.
2 min read
Grandstream GWN and guest WiFi: captive portal setup with Purple
How Grandstream GWN access points work with Purple guest WiFi: an external splash page, RADIUS and a walled garden, with a link to Purple's step-by-step setup guide for the exact configuration.
2 min read
Fortinet FortiAP and guest WiFi: captive portal setup with Purple
How Fortinet FortiAP access points managed in FortiCloud work with Purple guest WiFi using an external captive portal, RADIUS and a walled garden, without replacing your kit.
2 min read
SonicWall and guest WiFi: captive portal setup with Purple
How SonicWall firewalls and SonicWave access points work with Purple guest WiFi: external web authentication, RADIUS and a walled garden, with a link to Purple's step-by-step setup guide for the exact configuration.
2 min read
OpenWrt and guest WiFi: captive portal setup with Purple
How Purple's cloud guest WiFi works with OpenWrt devices through a standard external captive portal and RADIUS, and where to check support and find the steps.
2 min read
UniFi captive portal setup guide
How to add a Purple captive portal to Ubiquiti UniFi: an external portal server, controller authorization and a walled garden, with a link to Purple's step-by-step setup guide for the exact configuration.
2 min read
Captive portal for Cisco Meraki: set it up with Purple guest WiFi
How to run a Purple captive portal on Cisco Meraki: external web authentication, RADIUS and a walled garden, with a link to Purple's step-by-step setup guide for the exact configuration.
2 min read
Captive portal for Ruckus Cloud: set it up with Purple guest WiFi
How to run a Purple captive portal on Ruckus Cloud (Ruckus One): a third-party WISPr captive portal, an integration key and a walled garden, with a link to Purple's step-by-step setup guide for the exact configuration.
2 min read
Arista Networks AP and guest WiFi: captive portal setup with Purple
How Purple's cloud guest WiFi sits on top of Arista Networks access points using external web authentication and RADIUS, and where to find the exact setup steps.
2 min read
EnGenius and guest WiFi: captive portal setup with Purple
How Purple's cloud guest WiFi works with EnGenius access points through a standard external captive portal and RADIUS, and where to check support and find the steps.
2 min read
Alcatel-Lucent OmniAccess Stellar and guest WiFi: captive portal setup with Purple
How Alcatel-Lucent OmniAccess Stellar access points, managed from OmniVista Cirrus, work with Purple guest WiFi: an external captive portal, RADIUS and a walled garden, with a link to Purple's step-by-step setup guide for the exact configuration.
2 min read
Zyxel Nebula and guest WiFi: captive portal setup with Purple
How Zyxel Nebula Cloud access points work with Purple guest WiFi: an external captive portal, RADIUS and a walled garden, with a link to Purple's step-by-step setup guide for the exact configuration.
2 min read
Juniper Mist and guest WiFi: captive portal setup with Purple
How Juniper Mist access points work with Purple guest WiFi using an external portal and the Mist API secret, including what differs because Mist does not use RADIUS for the captive portal.
2 min read
Ubiquiti UniFi and guest WiFi: captive portal setup with Purple
How Ubiquiti UniFi Network works with Purple guest WiFi: an external portal server, controller authorisation and a walled garden, with a link to Purple's step-by-step setup guide for the exact configuration.
2 min read
Cambium cnPilot and guest WiFi: captive portal setup with Purple
How Cambium cnPilot Enterprise access points work with Purple guest WiFi using an external captive portal, RADIUS and a white list, without replacing your kit.
2 min read
Allied Telesis TQ Series AP and guest WiFi: captive portal setup with Purple
How Allied Telesis TQ Series access points work with Purple guest WiFi: an external page redirect, RADIUS and a walled garden, with a link to Purple's step-by-step setup guide for the exact configuration.
2 min read
Cisco Meraki and guest WiFi: captive portal setup with Purple
How Cisco Meraki access points and MX and Z-series appliances work with Purple guest WiFi: external web authentication, RADIUS and a walled garden, with a link to Purple's step-by-step setup guide for the exact configuration.
2 min read
Sophos Firewall and guest WiFi: captive portal setup with Purple
How Purple's cloud guest WiFi works with Sophos Firewall and its access points through a standard external captive portal and RADIUS, and where to check support and find the steps.
2 min read
Alta Labs AP and guest WiFi: captive portal setup with Purple
How Alta Labs access points work with Purple guest WiFi through an external captive portal, an authorisation secret and an IAPP key, with an honest note on the analytics that need RADIUS, and a link to Purple's step-by-step setup guide.
2 min read
Troubleshooting Captive Portal Redirects: Resolving Guest WiFi Connection Failures
When guests connect to your WiFi but cannot access the internet, the cause is almost always a misconfigured captive portal redirect - not a hardware fault. This guide provides a deep-dive technical reference for IT managers, network architects, and CTOs to diagnose and resolve the full chain of failures: from OS-level connectivity probes and HSTS certificate conflicts through to RADIUS authorization gaps and DHCP exhaustion. It maps each failure mode to a concrete fix and shows how Purple's hardware-agnostic cloud overlay eliminates these issues across Cisco Meraki, HPE Aruba, Ruckus, Juniper Mist, Ubiquiti UniFi, Cambium, Extreme, and Fortinet deployments.
9 min read
Troubleshooting Public WiFi: Fixing 'Connected, No Internet' and Splash Page Redirection Failures
This authoritative technical reference guide explains the underlying mechanics of captive portal detection and details the six primary failure modes that prevent guest WiFi from connecting. It provides IT managers and network architects with a practical troubleshooting framework to resolve HTTP redirect issues, DNS conflicts, and MAC randomization challenges.
6 min read
Captive Portal Architecture: Security, Redirection, and Best Practices
A definitive technical reference on enterprise captive portal architecture. This guide unpacks network isolation, DNS redirection, RADIUS authentication, and security compliance for IT leaders deploying secure, data-rich guest WiFi networks.
5 min read
Optimizing B2B Captive Portals: Capturing Company Names and Professional Data
This guide explains how IT managers, network architects, and venue operations directors can configure B2B captive portals to capture professional data - company names, job titles, and business email addresses - at the point of WiFi login. It covers the full technical architecture from VLAN isolation and RADIUS authentication through to CRM integration with Salesforce and HubSpot, with CCPA/CPRA compliance built in. Venues that deploy this correctly turn their guest WiFi network into a first-party data engine and automated lead generation system.
8 min read
How to Set Up a Captive Portal on Starlink: A Guide for Remote & Maritime Venues
This guide details how to bypass the native Starlink hardware and integrate a cloud-managed captive portal using enterprise routing equipment. You will learn how to overcome the CGNAT limitation, enforce VLAN segmentation, manage satellite bandwidth constraints, and ensure regulatory compliance.
5 min read
Captive Portal Best Practices: Designing for High Conversion and Compliance
This technical guide gives IT managers, network architects, and venue operations directors a complete blueprint for deploying captive portals that balance network security with high user conversion. It covers the full architecture from VLAN segmentation and RADIUS authentication to CCPA/CPRA-compliant consent design and authentication method selection. Drawn from Purple's operational experience across 80,000+ venues and 440 million logins in 2024, every recommendation is grounded in real deployment data.
8 min read
Hotel Guest WiFi Architecture: PMS Integration, Captive Portals, and Bandwidth Control
This guide provides a comprehensive framework for architecting enterprise-grade hotel WiFi networks. It details the technical requirements for VLAN segmentation, PMS integration via FIAS, captive portal design, and per-client bandwidth control to ensure security, compliance, and optimal performance.
6 min read
Why is my guest WiFi not connecting? Troubleshooting captive portal issues
This authoritative technical reference guide explains the underlying mechanics of captive portal detection and details the six primary failure modes that prevent guest WiFi from connecting. It provides IT managers and network architects with a practical troubleshooting framework to resolve HTTP redirect issues, DNS conflicts, and MAC randomization challenges.
6 min read
Configuring Captive Portal Redirection on Enterprise Network Controllers
This authoritative guide details the technical architecture and vendor-specific configuration steps required to implement captive portal redirection on enterprise network controllers. It provides actionable guidance for IT teams on configuring walled gardens, integrating RADIUS authentication, and ensuring compliance with GDPR and PCI DSS.
6 min read
Step-by-Step Guide: Configuring Ruijie Wireless Controllers for Guest WiFi Captive Portals
This guide provides a complete technical walkthrough for configuring Ruijie wireless controllers and gateways to deploy enterprise-grade guest WiFi captive portals. It covers VLAN segmentation, external RADIUS authentication via WISPr protocol, walled garden configuration, and seamless integration with Purple's Identity-Based Networks platform to capture first-party data and drive measurable business value across hospitality, retail, and public-sector environments.
8 min read
Staff WiFi Captive Portal: Onboarding and Authenticating Employees
A comprehensive technical reference for IT leaders on designing and deploying staff WiFi captive portals. This guide covers EAP-TLS authentication, BYOD onboarding, VLAN segmentation, and bandwidth management to enhance operational efficiency and mitigate security risks.
6 min read
Integrating WeChat WiFi Login: Capturing Engagement via Social Captive Portals
This guide details how to integrate WeChat WiFi authentication into enterprise captive portals, covering the OAuth 2.0 architecture, RADIUS integration, and step-by-step deployment across Cisco Meraki, HPE Aruba, and Juniper Mist hardware. It gives IT managers and network architects a practical framework for capturing first-party data from WeChat's 1.3 billion users while driving engagement via Official Account follows and post-login redirects.
8 min read
Monetizing Guest WiFi Through Data Analytics and Splash Pages
This authoritative guide provides IT managers, network architects, and CTOs with a comprehensive technical framework for transforming guest WiFi from a cost centre into a high-yield first-party data asset. It outlines network architecture, data analytics integration, captive portal optimization, and global compliance strategies to drive measurable venue revenue.
11 min read
Why your captive portal is not loading on iPhone: Fix Apple CNA errors
Troubleshoot and fix captive portal popup failures on iPhone and iOS. Learn how Apple CNA, iCloud Private Relay, and MAC randomization break WiFi logins, and how to fix them.
10 min read
Custom Captive Portal: HTML and CSS Guide
This authoritative technical reference guide outlines the development standards, CSS architecture, and network-level constraints required to design and code a custom captive portal landing page. It provides frontend developers and network architects with actionable strategies to navigate Apple CNA and Android webview environments, ensuring pixel-perfect, compliant, and highly performant guest WiFi experiences.
11 min read
Captive Portal Authentication Methods Compared
This authoritative technical reference guide evaluates the architectural, operational, and compliance trade-offs of five core captive portal authentication methods. It provides network architects, IT directors, and marketing managers with the quantitative data and decision frameworks required to balance guest onboarding friction with data-collection requirements across enterprise venues.
6 min read
Captive Portal vs Splash Page
This authoritative guide breaks down the critical distinction between captive portals and splash pages in guest WiFi networks. It clarifies how the underlying network interception mechanism works in tandem with the visual guest interface, helping IT leaders and venue operators make informed architectural and procurement decisions.
8 min read
Captive portal login troubleshooting and fixes
Troubleshoot captive portal login failures step by step. Fix CNA popup suppression, HSTS certificate errors, NeverSSL probes, and RADIUS timeout issues.
3 min read
How to Set Up a WiFi Hotspot for Your Business
This authoritative guide provides IT leaders, network architects, and venue operations directors with a practical, vendor-neutral blueprint for deploying secure, compliant, and business-enhancing guest WiFi hotspots. It covers critical architecture decisions - from VLAN segmentation and captive portal configuration to CCPA/CPRA compliance and traffic shaping - and demonstrates how to transform network infrastructure from a cost center into a revenue-driving analytics platform using Purple's Guest WiFi and analytics capabilities.
9 min read
Purple vs GlobalReach Technology: Carrier-Grade WiFi Compared
This guide provides an authoritative technical comparison of Purple and GlobalReach Technology across captive portal capabilities, WBA OpenRoaming readiness, carrier offload architecture, and commercial models. It is written for IT managers, network architects, and CTOs at hotels, retail chains, stadiums, and municipalities who need to make a platform decision this quarter. The core finding is that while GlobalReach leads in deep MNO carrier offload and standards authorship, Purple disrupts the market with a hardware-agnostic overlay and a genuinely free OpenRoaming Identity Provider tier, making carrier-grade WiFi accessible to any venue without upfront software licensing costs.
9 min read
The 10 Best WiFi Splash Page Examples (And What Makes Them Work)
A technical reference guide for IT managers, network architects, and venue operations directors covering the design, architecture, and deployment of high-converting WiFi splash pages. The guide analyses 10 real-world implementation strategies across hospitality, retail, events, and public-sector environments, with specific guidance on authentication methods, GDPR compliance, walled garden configuration, and MAC randomization mitigation.
8 min read
WiFi Guest Portal: What It Is and How to Optimise It
This authoritative guide details the architecture, implementation, and optimisation of WiFi guest portals. It provides actionable strategies for IT leaders to increase login completion rates, ensure GDPR compliance, and capture high-quality first-party data.
5 min read
How to Create a Custom WiFi Login Page for Your Brand
This guide provides a comprehensive, implementation-ready reference for IT managers, network architects, and venue operations directors on how to create a fully branded guest WiFi login page - covering captive portal architecture, HTML/CSS customization, CCPA/CPRA compliance, and data capture strategy. It moves from technical foundations through to real-world deployment scenarios in hospitality and retail, with measurable business outcomes at each stage. For organizations running Purple's guest WiFi platform, the guide maps directly to the platform's portal builder, analytics, and consent management capabilities.
5 min read
How to Create a Guest WiFi Login Page
This authoritative guide details the technical architecture, UX best practices, and CRM integration strategies for deploying a branded guest WiFi login page (captive portal) in enterprise venues. Designed for IT managers, network architects, and venue operations directors, it provides actionable frameworks for balancing data capture requirements with user friction, ensuring CCPA/CPRA compliance, and maximizing ROI from guest WiFi infrastructure.
9 min read
SMS vs Email Verification for Guest WiFi: Which to Choose
A comprehensive, data-driven technical comparison of SMS and Email verification methods for guest WiFi captive portals, covering conversion rates, architecture, per-verification costs, compliance requirements, and venue-specific deployment recommendations. Essential reading for IT managers, network architects, and venue operations directors designing or optimising guest WiFi sign-up flows.
7 min read
Age Verification on Guest WiFi: Compliance for Gaming, Alcohol, and Adult Venues
This authoritative technical reference guide explores the implementation of age verification on guest WiFi networks for high-risk venues like casinos, bars, and stadiums. It details compliance strategies, architectural deployment models, and the balance between regulatory requirements and user onboarding friction.
4 min read
Network Onboarding UX: Designing a Frictionless WiFi Setup Experience
This guide provides a comprehensive technical framework for designing a frictionless WiFi network onboarding UX, covering captive portal detection mechanics across iOS, Android, Windows, and macOS, and detailing self-service certificate enrolment for 802.1X staff networks. It equips IT managers, network architects, and venue operations directors with actionable strategies to reduce helpdesk overhead, improve first-connection success rates, and maintain GDPR and PCI DSS compliance across hospitality, retail, and campus environments.
9 min read
How Passpoint (Hotspot 2.0) Transforms the Guest WiFi Experience
A comprehensive technical reference guide detailing how Passpoint (Hotspot 2.0) and 802.11u protocols replace traditional captive portals with seamless, secure, cellular-like WiFi roaming. It provides IT leaders with architectural overviews, implementation frameworks, and the business case for adopting credential-based authentication to solve MAC randomisation challenges and improve guest experience.
6 min read
Guest WiFi Marketing: The Ultimate Guide to Capturing Leads, Driving Sales, and Enhancing Customer Experience
This guide provides a technical deep-dive into leveraging guest WiFi for marketing, lead capture, and customer analytics. It offers actionable strategies for IT managers and venue operators to transform their WiFi from a cost center into a powerful, ROI-driven marketing platform, covering architecture, implementation, and compliance.
5 min read
Guest WiFi: The Ultimate Guide for Businesses to Enhance Customer Experience and Gather Valuable Data
This guide is the definitive technical reference for IT leaders and venue operators on deploying enterprise-grade guest WiFi. It provides actionable guidance on network architecture, security, and data analytics to transform guest WiFi from a cost centre into a powerful tool for enhancing customer experience and driving business intelligence.
7 min read
Splash Page Design Best Practices for Guest WiFi
This guide provides IT managers, network architects, and venue operations directors with a definitive technical reference for designing and deploying high-performance guest WiFi splash pages. It covers the four core pillars of effective captive portal design - brand identity, user experience, data capture, and legal compliance - and translates them into actionable deployment guidance. By following these best practices, organisations can expect measurable improvements in guest connection rates, marketing database growth, and demonstrable ROI from their guest WiFi infrastructure.
9 min read
Walled Garden Configuration for Guest WiFi
This guide provides a comprehensive, vendor-neutral technical reference for configuring walled gardens in enterprise guest WiFi deployments. It covers the architecture of pre-authentication access, the critical role of dynamic DNS resolution, social login domain whitelisting, OS captive portal probe requirements, and compliance considerations under PCI DSS and GDPR. Aimed at IT managers, network architects, and venue operations directors, it delivers actionable implementation guidance with real-world case studies from hospitality, retail, and events environments.
11 min read
Frequently asked questions
What is a captive portal?
A captive portal is the page that appears when a device joins a public WiFi network and holds it there until the user accepts terms or signs in. The access point then releases the device onto the internet.
Do I need new hardware to run a captive portal?
No. Purple is hardware-agnostic and runs on access points from Cisco Meraki, HPE Aruba, Ruckus, Juniper Mist, Ubiquiti UniFi, Cambium, Extreme and Fortinet.
Which sign-in methods can a captive portal use?
The common ones are click-through terms, an email form, social login, SMS verification and voucher codes. The captive portal guide compares each method and where it fits.
Can a captive portal collect data under GDPR?
Yes, if consent is handled properly. Marketing opt-ins must be a separate, unticked choice with a link to your privacy notice. Purple is ISO 27001 certified and GDPR compliant.
Got a question about your own network?
Our team works with IT teams and venue operators across 80,000 venues. Book a 20-minute call and we will show you how others solved it.