Skip to main contentSkip to search
Skip to main content

Portal Pages

Customize the look and feel of your captive portal pages. IronWiFi provides a visual editor for basic customization and full HTML/CSS access for advanced branding.

Quick Start

  1. Navigate to your Captive Portal > Portal Pages
  2. Select the page to edit (Splash, Success, Error, Terms)
  3. Use the Visual Editor for drag-and-drop customization
  4. Or click Edit Source for HTML/CSS access
  5. Upload assets to File Library
  6. Click Save and test on a mobile device

Available Pages

PageWhen DisplayedPurposeKey Elements
Splash PageWhen user first connects to WiFiAuthentication gatewayLogo, welcome message, login options, terms link
Success PageAfter successful authenticationConfirm access grantedConfirmation message, usage instructions, promotional content
Error PageWhen authentication failsHelp user recoverError description, retry instructions, support contact
Terms PageLinked from splash pageLegal complianceTerms of service, privacy policy, acceptable use policy

Splash Page

The main landing page when users connect to your network.

Default Elements:

  • Logo
  • Welcome message
  • Authentication options
  • Terms of service link

Success Page

Displayed after successful authentication.

Typical Content:

  • Confirmation message
  • Usage instructions
  • Optional promotional content

Error Page

Shown when authentication fails.

Should Include:

  • Clear error message
  • Instructions to retry
  • Support contact information

Terms Page

Your terms of service and acceptable use policy.

Requirements:

  • Legal terms
  • Privacy policy
  • Usage restrictions

Customization Options

Visual Editor

Use the drag-and-drop editor for basic customization:

  • Add/remove elements
  • Change colors and fonts
  • Upload logos and images
  • Rearrange layout

HTML/CSS Editor

For advanced customization, edit the source code directly:

  1. Navigate to Portal Pages
  2. Select a page
  3. Click Edit Source
  4. Modify HTML/CSS
  5. Click Save

Responsive Design

Ensure your pages work on all devices:

  • Mobile phones
  • Tablets
  • Laptops
  • Large screens
tip

Test your portal on multiple devices before deploying.

Technical Limitations

Understanding the technical constraints helps you build reliable portal pages.

HTML/CSS Support

FeatureSupportNotes
HTML5FullAll semantic elements supported
CSS3FullFlexbox, Grid, animations, transitions
CSS VariablesFull
--custom-properties
work correctly
Media QueriesFullEssential for responsive design
Web FontsFullWOFF2, WOFF, TTF supported
SVGFullInline and external SVG files

JavaScript Limitations

FeatureSupportNotes
ES6+PartialTranspile for older browser support
External LibrariesAllowedjQuery, Bootstrap JS, etc.
Fetch APIFullFor AJAX requests
localStorageLimitedMay be cleared on portal reload
Service WorkersNot SupportedCaptive portals don't support SW
WebSocketsNot RecommendedConnection may be interrupted
warning

Avoid complex JavaScript that requires persistent state. The captive portal environment may reload pages unexpectedly.

File Size Limits

File TypeMax SizeRecommendation
HTML500 KBKeep under 100 KB
CSS500 KBKeep under 50 KB
JavaScript500 KBKeep under 100 KB
Images2 MB eachCompress to under 200 KB
Total Page5 MBAim for under 1 MB

Security Restrictions

For security, the following are restricted:

  • Inline
    <script>
    with external sources
    - Use uploaded JS files instead
  • External CDN resources - Must be in Walled Garden or uploaded
  • Form submissions to external URLs - Authentication must go through IronWiFi
  • iframes from external domains - Only same-origin or whitelisted
  • Access to device APIs - Camera, microphone, location require user consent

Best Practices for Performance

  1. Optimize images - Use WebP format, compress JPG/PNG
  2. Minimize CSS/JS - Remove unused code, use minified versions
  3. Avoid external resources - Upload all assets to File Library
  4. Use system fonts - Reduces load time vs custom fonts
  5. Lazy load non-critical resources - Defer JavaScript execution
  6. Enable Cloud CDN - For faster global delivery

Template Variables

Use these variables in your HTML for dynamic content:

User Variables

Network Variables

Portal Variables

File Library

Upload assets for use in your portal pages:

Supported File Types

  • Images: PNG, JPG, GIF, SVG
  • Styles: CSS
  • Scripts: JavaScript
  • Fonts: WOFF, WOFF2, TTF

Uploading Files

  1. Navigate to Portal Pages > File Library
  2. Click Upload
  3. Select files
  4. Click Save

Referencing Files

Use relative paths in your HTML:

Sample Splash Page

Branding Guidelines

  • Recommended size: 200x60 pixels
  • Format: PNG with transparency
  • File size: Under 100KB

Colors

  • Define brand colors in CSS variables
  • Ensure sufficient contrast for readability
  • Consider dark mode support

Typography

  • Use web-safe fonts or upload custom fonts
  • Minimum 16px for body text
  • Clear hierarchy with headings

Multi-Language Support

To support multiple languages:

  1. Create a splash page with language detection
  2. Use JavaScript to redirect based on browser language
  3. Or provide manual language selection

Example:

Testing Your Portal

Before deploying:

  1. Browser Testing - Test on Chrome, Firefox, Safari, Edge
  2. Device Testing - Mobile, tablet, desktop
  3. Authentication Testing - Verify all providers work
  4. Edge Cases - Test error scenarios
  5. Performance - Check loading speed

Common Issues

Page Not Loading

  • Verify Walled Garden configuration
  • Check splash URL is correct
  • Ensure CDN is enabled if needed

Images Not Displaying

  • Verify file is uploaded to File Library
  • Check path is correct (relative path)
  • Confirm file format is supported

Styles Not Applied

  • Check CSS syntax
  • Verify CSS file is linked correctly
  • Clear browser cache

Sample Templates

Hotel/Hospitality Template

Café/Restaurant Template

Event/Conference Template

Enterprise Guest Template

Success Page Template

Error Page Template

Terms of Service Page Template

Accessibility Guidelines

Ensure your portal pages are accessible to all users:

Color Contrast

  • Minimum contrast ratio: 4.5:1 for normal text, 3:1 for large text
  • Test with tools like WebAIM Contrast Checker
  • Avoid using color alone to convey information

Keyboard Navigation

Screen Reader Support

Form Accessibility

Mobile Accessibility

  • Minimum touch target size: 44x44 pixels
  • Sufficient spacing between interactive elements
  • Support pinch-to-zoom (don't disable)
  • Test with screen readers (VoiceOver, TalkBack)

Data Collection Forms

Custom Registration Form Example

Was this page helpful?