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
- Navigate to your Captive Portal > Portal Pages
- Select the page to edit (Splash, Success, Error, Terms)
- Use the Visual Editor for drag-and-drop customization
- Or click Edit Source for HTML/CSS access
- Upload assets to File Library
- Click Save and test on a mobile device
Available Pages
| Page | When Displayed | Purpose | Key Elements |
|---|---|---|---|
| Splash Page | When user first connects to WiFi | Authentication gateway | Logo, welcome message, login options, terms link |
| Success Page | After successful authentication | Confirm access granted | Confirmation message, usage instructions, promotional content |
| Error Page | When authentication fails | Help user recover | Error description, retry instructions, support contact |
| Terms Page | Linked from splash page | Legal compliance | Terms 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:
- Navigate to Portal Pages
- Select a page
- Click Edit Source
- Modify HTML/CSS
- Click Save
Responsive Design
Ensure your pages work on all devices:
- Mobile phones
- Tablets
- Laptops
- Large screens
Test your portal on multiple devices before deploying.
Technical Limitations
Understanding the technical constraints helps you build reliable portal pages.
HTML/CSS Support
| Feature | Support | Notes |
|---|---|---|
| HTML5 | Full | All semantic elements supported |
| CSS3 | Full | Flexbox, Grid, animations, transitions |
| CSS Variables | Full | |
| Media Queries | Full | Essential for responsive design |
| Web Fonts | Full | WOFF2, WOFF, TTF supported |
| SVG | Full | Inline and external SVG files |
JavaScript Limitations
| Feature | Support | Notes |
|---|---|---|
| ES6+ | Partial | Transpile for older browser support |
| External Libraries | Allowed | jQuery, Bootstrap JS, etc. |
| Fetch API | Full | For AJAX requests |
| localStorage | Limited | May be cleared on portal reload |
| Service Workers | Not Supported | Captive portals don't support SW |
| WebSockets | Not Recommended | Connection may be interrupted |
Avoid complex JavaScript that requires persistent state. The captive portal environment may reload pages unexpectedly.
File Size Limits
| File Type | Max Size | Recommendation |
|---|---|---|
| HTML | 500 KB | Keep under 100 KB |
| CSS | 500 KB | Keep under 50 KB |
| JavaScript | 500 KB | Keep under 100 KB |
| Images | 2 MB each | Compress to under 200 KB |
| Total Page | 5 MB | Aim for under 1 MB |
Security Restrictions
For security, the following are restricted:
- Inline with external sources - Use uploaded JS files instead
<script> - 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
- Optimize images - Use WebP format, compress JPG/PNG
- Minimize CSS/JS - Remove unused code, use minified versions
- Avoid external resources - Upload all assets to File Library
- Use system fonts - Reduces load time vs custom fonts
- Lazy load non-critical resources - Defer JavaScript execution
- 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
- Navigate to Portal Pages > File Library
- Click Upload
- Select files
- Click Save
Referencing Files
Use relative paths in your HTML:
Sample Splash Page
Branding Guidelines
Logo
- 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:
- Create a splash page with language detection
- Use JavaScript to redirect based on browser language
- Or provide manual language selection
Example:
Testing Your Portal
Before deploying:
- Browser Testing - Test on Chrome, Firefox, Safari, Edge
- Device Testing - Mobile, tablet, desktop
- Authentication Testing - Verify all providers work
- Edge Cases - Test error scenarios
- 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
Related Topics
Was this page helpful?