Accounts

Users

The Users module manages all WiFi guest accounts in the tenant. Each user has credentials, an assigned access profile, usage counters, and optional MAC/zone restrictions.

'alt' => 'Dashboard overview', 'caption' => 'The default Kiwire dashboard layout', 'screenshot' => true, 'class' => '', ]) Drop images into: public/assets/img/docs/{page}/{filename} --}}

Image not uploaded yet public/assets/img/docs/users/overview.png

The Users grid — searchable, paginated, with inline actions.

Key Fields

Field	Description
`username`	Login credential — unique per tenant (max 120 chars)
`password`	Encrypted — never shown in plain text
`fullname`, `email_address`, `phone_number`	Contact information
`status`	`active` · `inactive` · `expired` · `suspended`
`profile_subs`	Subscribed / base access profile
`profile_curr`	Current active profile (may differ after top-up)
`date_activate` / `date_expiry`	Account validity window
`session_time`	Total session minutes consumed
`quota_in` / `quota_out`	Bytes downloaded / uploaded
`login_count`	Total login events
`allowed_zone`	Comma-separated zone IDs the user is restricted to
`allowed_mac`	Allowed MAC addresses (blank = any device)
`login_type`	Which login method was used to create this account
`subtenant_id`	Sub-tenant this user belongs to (if applicable)

Available Actions

Create User

Open the side panel with Add User. Required: username, password, profile_subs. Optional: contact fields, zone/MAC restrictions, expiry date. Usernames must be unique within the tenant.

Edit User

Click a row to open the edit panel. All fields except username (immutable) and password (separate action) can be updated. Change the profile to instantly switch the user's access tier.

Reset Usage

Resets session_time, quota_in, quota_out, and login_count back to zero. The user keeps their account — only counters are cleared. Useful for testing or manual plan renewal.

Import & Export

Import — Upload a CSV file. Required columns: username, password. Optional: all other fields. Duplicate usernames are skipped. The import streams progress in real time.
Export — Downloads all users as a CSV file (respects current grid filters).

User Detail Tabs

Click a row's eye icon (or expand) to see sub-tabs:

Tab	Shows
Devices	MAC addresses and device types seen for this account
Login Records	Full chronological login/logout history
Active Sessions	Currently online sessions (if any)
Login Via	Which login methods (Google, SMS, etc.) the user has connected
Auto-Login	MAC-based auto-login tokens assigned to the user
Certificates	WiFi certificates issued to this user

Status Values

active — user can log in normally
inactive — account exists but login is blocked
expired — account passed date_expiry; login blocked
suspended — manually suspended by an admin

Kiwire automatically sets status to expired when date_expiry is in the past. You do not need to manually change it unless you want to pre-block an account.

Required Permissions

view-users · create-users · update-users · delete-users