Settings & Preferences

Control your WiFi portal's global configuration including business details, SMS notifications, customer sign-up flows, and automatic free WiFi distribution.

Quick Start

Navigate to Settings in the sidebar. All changes take effect immediately after clicking Save.

First-Time Setup

Complete Company Information and Currency settings before creating packages. Currency cannot be changed retroactively for existing packages.

Field	Description	Example
Company Name	Your business name displayed to customers	Grand Hotel, Coffee House
Country	Operating country for regional compliance	United States, United Kingdom
Company Email	Contact email for notifications and support	support@grandhotel.com
Time Zone	Local timezone for accurate reports	America/New_York, Europe/Paris
Currency	3-letter code for pricing (USD, EUR, GBP, INR)	USD

SMS Configuration

Enable text message notifications for customer verification, purchases, and alerts.

Enable SMS Notifications

Enable SMS - Master toggle for all SMS functionality. When disabled, OTP login won't work.

SMS Gateway - Select Custom (currently the only supported gateway).

Calling URL - API endpoint for your SMS provider (required when Custom gateway selected).

Subscriber OTP Verify Required - Require OTP verification for new customer sign-ups.

SMS Templates

Click Manage SMS Templates to customize message content for different events.

Template Types

Type	Purpose	Sent When
OTP	One-time password for login	Customer requests access code
Welcome	Welcome message	New customer signs up
Package Purchase	Purchase confirmation	Customer buys a package
Package Expiry	Expiration warning	Package nearing expiry
Low Balance	Data/time alert	Balance running low

One Template Per Type

Each type can only be created once. Edit existing templates to make changes.

Creating a Template

Click + Add Template and configure:

Template Type - Select from available types (already-created types won't appear)
Template Content - Message text with variable placeholders (see below)
DLT ID - Distributed Ledger Technology ID for compliance (required in India)

Variable Reference

Click variable tags to insert them at cursor position. Variables are case-sensitive.

OTP Template

{{otp}} - Verification code
{{location.name}} - Location name
{{validity}} - OTP validity in minutes

Welcome Template

{{name}} - Customer name
{{phone}} - Phone number
{{location.name}} - Location name

Package Purchase

{{package_name}} - Package name
{{price}} - Package price
{{validity}} - Package duration
{{data_limit}} - Data allowance
{{speed}} - Bandwidth limit

Package Expiry

{{package_name}} - Package name
{{expiry_date}} - Expiration date
{{days_remaining}} - Days until expiry

Low Balance

{{balance}} - Current balance
{{data_remaining}} - Data remaining
{{time_remaining}} - Time remaining

Example Templates

OTP:
Your WiFi verification code is {{otp}}. Valid for {{validity}} minutes at {{location.name}}.

Welcome:
Welcome {{name}} to {{location.name}}! Your WiFi access is now active.

Package Purchase:
You purchased {{package_name}} for {{price}}. Valid for {{validity}}. Enjoy!

Package Expiry:
Your {{package_name}} expires {{expiry_date}} ({{days_remaining}} days remaining).

Low Balance:
Balance: {{balance}}. Data remaining: {{data_remaining}}.

Keep It Short

Keep messages under 160 characters to avoid multi-part SMS charges. Test templates by sending to yourself first.

Captive Portal Configuration

Control customer sign-up behavior and automatic free WiFi assignment.

Enable Sign Up - Allow customers to create accounts from the WiFi login page.

Require Name - Make name field mandatory (enabled by default).

Require Email - Make email field mandatory (enabled by default).

Choose Your Approach

Guest Access - Disable name/email requirements for minimal friction
Marketing/CRM - Enable both to collect customer data
Managed Access - Disable sign-up entirely and create accounts manually

Free WiFi Packages

Automatically assign Trial packages to new customers.

Free Package - Select Trial package to auto-assign when customers connect.

Trial Package Required

Only Trial-type packages appear in the dropdown. Create a Trial package from Packages first.

Free Package Auto Renew - Automatically renew package when it expires.

Renewal Interval - Amount before auto-renewal (e.g., 1, 7, 30).

Renewal Interval Unit - Period for interval: Hour, Day, Week, Month, Year.

Auto-Renew Example

1 Day = Customers get fresh free package every 24 hours (perfect for cafes offering daily free WiFi)

2 Hours = Customers can reconnect every 2 hours (good for shopping malls)

OTP Settings

OTP Expiry Minutes - Minutes before OTP code expires (default: 5, minimum: 1).

Max OTP Attempts - Maximum verification attempts before blocking (default: 3, minimum: 1).

Security Balance

Expiry: 5-10 minutes balances security and user experience
Attempts: 3-5 attempts prevents brute-force while allowing typos

Use Cases & Examples

Hotel / Resort

Goal: Controlled access with front desk managing accounts.

yaml

Company Name: Grand Hotel
Currency: USD
Time Zone: America/New_York

SMS: Enabled
OTP Verify: Enabled
OTP Expiry: 10 minutes
Max Attempts: 3

Sign Up: Disabled
Free Package: 24-Hour Guest WiFi (Trial)
Auto Renew: Disabled

Cafe / Restaurant

Goal: Open access with marketing data collection.

yaml

Company Name: Coffee House
Currency: EUR
Time Zone: Europe/Paris

SMS: Enabled
Sign Up: Enabled
Require Name: Yes
Require Email: Yes

Free Package: 1-Hour Free WiFi (Trial)
Auto Renew: Enabled
Renewal Interval: 1 Day

Shopping Mall

Goal: Quick guest access with minimal friction.

yaml

Company Name: Central Mall
Currency: INR
Time Zone: Asia/Kolkata

SMS: Enabled (with DLT ID for India)
Sign Up: Enabled
Require Name: No
Require Email: No

Free Package: 30-Minute Mall WiFi (Trial)
Auto Renew: Enabled
Renewal Interval: 2 Hours

Co-working Space

Goal: Member-only access with admin-managed accounts.

yaml

Company Name: WorkHub
Currency: GBP
Time Zone: Europe/London

SMS: Disabled
Sign Up: Disabled
Free Package: None (admins assign packages)

Best Practices

Set time zone accurately - Ensures reports and analytics match your local time.

Choose currency first - Set before creating packages to avoid pricing confusion.

Match renewal to validity - 1-day package should have 1-day renewal interval.

Test SMS templates - Send test messages to yourself before enabling for customers.

Keep SMS under 160 chars - Avoid multi-part SMS charges from your provider.

Balance OTP security - Use 5-10 minute expiry and 3-5 max attempts.

Sign-up strategy:

Hotels: Disable sign-up, create accounts manually
Cafes/Public spaces: Enable sign-up with email for marketing
Retail: Enable sign-up without email for quick access

Create Trial packages early - Required for automatic free WiFi distribution.

Troubleshooting

Cause: No Trial packages exist.

Fix: Go to Packages and create a package with Package Type: Trial.

Customers not receiving OTP

Cause: SMS not configured properly.

Fix:

Verify Enable SMS is toggled on
Ensure SMS Gateway is set to Custom
Check Calling URL is correct
Confirm your SMS service provider is active

SMS variables showing as `{{variable}}` text

Cause: Variable mismatch or typo.

Fix:

Ensure variable names match exactly (case-sensitive)
Only use variables listed for that specific template type
Click variable tags instead of typing manually

Auto-renew not working

Cause: Misconfigured renewal settings.

Fix:

Verify Free Package Auto Renew is enabled
Check Renewal Interval matches package validity
Ensure package hasn't been manually revoked

Settings not saving

Cause: Validation error or required field missing.

Fix:

Check all required fields are filled (marked with *)
Verify currency code is 3 letters (USD, EUR, etc.)
Ensure OTP settings meet minimum values

Next Steps

Test Your Configuration

After saving settings, test the customer experience:

Connect to your WiFi portal from a customer device
Verify sign-up flow works as expected
Confirm free package assignment
Test OTP SMS delivery

Settings & Preferences ​

Quick Start ​

Company Information ​

SMS Configuration ​

Enable SMS Notifications ​

SMS Templates ​

Template Types ​

Creating a Template ​

Variable Reference ​

Example Templates ​

Captive Portal Configuration ​

Sign-Up Settings ​

Free WiFi Packages ​

OTP Settings ​

Use Cases & Examples ​

Hotel / Resort ​

Cafe / Restaurant ​

Shopping Mall ​

Co-working Space ​

Best Practices ​

Troubleshooting ​

Free Package dropdown is empty ​

Customers not receiving OTP ​

SMS variables showing as {{variable}} text ​

Auto-renew not working ​

Settings not saving ​

Next Steps ​

Settings & Preferences

Quick Start

Company Information

SMS Configuration

Enable SMS Notifications

SMS Templates

Template Types

Creating a Template

Variable Reference

Example Templates

Captive Portal Configuration

Sign-Up Settings

Free WiFi Packages

OTP Settings

Use Cases & Examples

Hotel / Resort

Cafe / Restaurant

Shopping Mall

Co-working Space

Best Practices

Troubleshooting

Free Package dropdown is empty

Customers not receiving OTP

SMS variables showing as `{{variable}}` text

Auto-renew not working

Settings not saving

Next Steps