Operator documentation
Subscriber Portal Options
The subscriber portal is the customer self-care area. Subscribers sign in at `/user_login` and use authenticated routes under `/portal`, including dashboard, bi
Subscriber Portal Options
The subscriber portal is the customer self-care area. Subscribers sign in at /user_login and use authenticated routes under /portal, including dashboard, billing, plans, support, profile, and usage pages.
ISP administrators configure subscriber portal behavior from /settings/subscriber-portal.
Feature Toggles
| Option | Database Field | Default | Affected Area |
|---|---|---|---|
| Allow Plan Upgrade | allow_plan_upgrade |
Disabled | Enables plan upgrade actions in /portal/plans. |
| Allow Plan Downgrade | allow_plan_downgrade |
Disabled | Reserved for downgrade behavior where supported by the plan flow. |
| Allow Password Change | allow_password_change |
Enabled | Enables password update in /portal/profile. |
| Allow Profile Edit | allow_profile_edit |
Enabled | Enables subscriber profile updates in /portal/profile. |
| Allow Ticket Creation | allow_ticket_creation |
Disabled | Enables support ticket routes under /portal/support. |
| Allow Online Payment | allow_online_payment |
Disabled | Enables invoice payment and wallet recharge actions. |
| Allow Invoice Download | allow_invoice_download |
Enabled | Enables invoice PDF downloads. |
Feature-gated routes use the portal.feature middleware, so disabled options block the backend route as well as hiding the UI action.
Display Options
| Option | Database Field | Default | Effect |
|---|---|---|---|
| Show Data Usage | show_data_usage |
Enabled | Shows subscriber usage data in portal views. |
| Show Usage Graph | show_usage_graph |
Enabled | Shows graph-based usage visualization where available. |
| Show Invoice History | show_invoice_history |
Enabled | Shows historical invoices. |
| Show Payment History | show_payment_history |
Enabled | Shows historical payments. |
| Show Expiry Date | show_expiry_date |
Enabled | Shows service expiry or renewal date. |
Display options control what subscribers can see. Feature toggles control what subscribers can do.
Login And Session Options
| Option | Database Field | Allowed Values |
|---|---|---|
| Login Methods | login_methods |
username, mobile, email, username_mobile, all |
| Session Timeout | session_timeout_minutes |
5 to 1440 minutes |
| Max Devices | device_limit |
1 to 20 devices |
| Concurrent Sessions | concurrent_sessions |
1 to 10 active sessions |
Use stricter session values for public kiosks or shared environments. Use a wider device limit only when the ISP explicitly supports multi-device subscriber access.
Branding And Domain Options
| Option | Database Field | Notes |
|---|---|---|
| Theme Color | custom_theme_color |
Hex color used by subscriber portal branding. |
| Custom Logo | custom_logo_path |
Uploaded logo shown in the portal. |
| Welcome Message | welcome_message |
Login-page or portal welcome text. |
| Custom CSS | custom_css |
Tenant-specific CSS override. Keep it small and review before saving. |
| Custom Domain | custom_domain |
Subscriber-facing domain such as panel.example-isp.com. |
| Domain Verification Token | domain_verification_token |
TXT record token used to verify domain ownership. |
| Domain Verified At | domain_verified_at |
Timestamp proving the domain passed DNS verification. |
The custom domain should CNAME to the configured application domain. DNS verification requires a TXT value in the form nowacrm-verify=<token>.
Route Impact
| Portal Route | Relevant Toggle |
|---|---|
/portal/dashboard |
Display options such as usage, graph, and expiry visibility. |
/portal/billing/invoices/{invoice}/download |
allow_invoice_download |
/portal/billing/invoices/{invoice}/pay |
allow_online_payment |
/portal/billing/wallet/recharge |
allow_online_payment |
/portal/plans/upgrade/{plan} |
allow_plan_upgrade |
/portal/support/* |
allow_ticket_creation |
/portal/profile updates |
allow_profile_edit, allow_password_change |
Recommended Setup Order
- Choose the subscriber login methods.
- Set session timeout, max devices, and concurrent sessions.
- Enable only the self-service actions the ISP is operationally ready to support.
- Configure payment gateway settings before enabling online payments.
- Configure invoice templates before enabling invoice downloads.
- Add subscriber portal branding.
- Add and verify the custom domain.
- Test with one active subscriber before announcing the portal broadly.