Users¶
Manage all user accounts on your platform including customers, vendors, and administrators. Control access, roles, and user information.
Overview¶
Users section allows you to:
- Create and manage accounts for customers, vendors, staff
- Assign roles and permissions
- Update user information and contact details
- Manage loyalty points and levels
- Configure cart settings per user
- Manage user addresses
- Reset passwords and manage access
- Track user activity and status
- Suspend or activate accounts
Accessing Users¶
Click Modules → User Management → Users

Understanding Users¶
User Types¶
- Customer: Regular shoppers on your platform
- Vendor: Sellers/suppliers (can have assigned categories)
- Administrator: Staff with management access
- Support Staff: Customer service team
User Fields¶
- Name: Full name (required)
- Email: Contact email (unique)
- Mobile: Contact phone number
- Date of Birth: User's birth date
- Gender: Male or Female
- Password: Account password
- Active: Account status toggle
- Email Verified: Email verification status
- Telegram Chat ID: For Telegram notifications
- Roles: Job function/permissions
Form Tabs¶
The user form is organized into 5 tabs for easier management:
Basic Information Tab¶

Contains core user profile fields:
- Name (required)
- Mobile
- Date of Birth
- Gender
- Password (required for new users)
- Active toggle
Custom Fields Tab¶

Displays any custom fields configured in User Custom Fields. These fields are dynamic and may include:
- Text fields
- Textarea fields
- File uploads
- Dropdown selections
- Boolean toggles
Loyalty Program Tab¶

Manage user loyalty information:
- Loyalty Points: Current points balance (read-only)
- Current Level: User's loyalty level (read-only)
- Monthly Purchases: Total purchases this month (read-only)
- Level Assignment Mode: Auto or Manual
- Manually Set Level: Override automatic level assignment
- Reset to Auto Mode: Return to automatic level calculation
Cart Settings Tab¶

Configure user-specific cart behavior:
- Holds Stock: When enabled, items in this user's cart will be reserved and unavailable to other customers
- Cart Expiry Days Override: Override the default cart expiry days for this user (leave empty for system default)
Advanced Tab¶

Advanced user settings:
- Email Verified: Toggle to manually mark email as verified
- Telegram Chat ID: Enter user's Telegram Chat ID for notifications (get it by messaging @chatIDrobot on Telegram)
- Roles: Assign one or more roles to the user
Managing Addresses¶
When editing a user, you can manage their addresses in the Addresses tab.

Each address includes:
- Title (e.g., Home, Work, Office)
- First Name and Last Name
- Company (optional)
- Phone number
- Address lines
- Street Name, Building Number, Floor Number
- Country, State/Province, City
- Postal Code
- Default Address toggle
- Billing Address toggle
- Shipping Address toggle
Row Actions¶

Click the actions menu (⋮) on any user row to access:
- Mark as Verified/Unverified: Toggle email verification status
- Edit: Open user edit form
- Delete: Remove user account
- Award Points: Add loyalty points to user
- Deduct Points: Remove loyalty points (if user has points)
- Set Level: Manually assign a loyalty level
- Reset to Auto: Return to automatic level assignment (if manually set)
Exporting Users¶
Export user data to Excel or PDF for customer analysis, marketing campaigns, or compliance reporting.
Export All: Click More → Export to download all users.
Export Selected: Select users with checkboxes, then choose Export from bulk actions.
Data Included: Name, email, mobile, roles, status, registration date, wallet balance, loyalty points.
Managing Users¶
Creating a User¶
- Click New User
- Fill in the Basic Information tab:
- Enter Name (required)
- Enter Email
- Enter Mobile (optional)
- Select Date of Birth (optional)
- Select Gender (optional)
- Enter Password (required)
- Toggle Active status
- Configure other tabs as needed
- Click Create
Editing User Info¶
- Click on a user row or the Edit action
- Navigate through tabs to update fields
- Modify Addresses in the Addresses tab
- Click Save changes
Resetting Password¶
- Edit the user
- In the Basic Information tab, enter a new password
- Leave the password field empty to keep the current password
- Save changes
Deactivating Users¶
- Edit the user
- Toggle Active to off
- Save
- User loses access immediately
Deleting Users¶
- Click the actions menu (⋮) on the user row
- Click Delete
- Confirm action
- User account permanently removed
User Search & Filtering¶
- Search by name, email, or mobile
- Filter by verification status (Verified/Unverified)
- Filter by active status
- Filter by role
- Filter by loyalty level
- Filter by stock holding status
- Sort by any column
Bulk Actions¶
Select multiple users to:
- Delete multiple accounts
- Mark as Verified: Set email as verified for selected users
- Mark as Unverified: Remove email verification for selected users
- Toggle Active Status: Switch active status for selected users
- Export: Download selected user data
Best Practices¶
- Secure access: Use strong initial passwords
- Verify email: Ensure email addresses are active
- Regular cleanup: Remove inactive accounts
- Role assignment: Grant minimum necessary permissions
- Monitor activity: Track login patterns
- Backup data: Export user lists regularly
- Use holds stock wisely: Only enable for VIP customers to avoid inventory issues
Common Workflows¶
Onboard New Customer¶
- Click New User
- Enter name and email
- Leave Roles empty (customers don't need admin roles)
- Ensure Active is toggled on
- Click Create
- User can login with set password
Add New Staff Member¶
- Click New User
- Fill in basic information
- Go to Advanced tab
- Assign appropriate role(s)
- Click Create
- Share login credentials securely
Award Loyalty Points¶
- Find user in list
- Click actions menu (⋮)
- Click Award Points
- Enter points amount and description
- Confirm
Set VIP Customer Level¶
- Find user in list
- Click actions menu (⋮)
- Click Set Level
- Select the desired level
- Confirm (this switches to manual mode)
Enable Stock Holding for VIP¶
- Edit the user
- Go to Cart Settings tab
- Enable Holds Stock
- Optionally set custom cart expiry days
- Save changes
Troubleshooting¶
Q: Can users reset their own passwords? A: Yes, through login page "Forgot Password" link.
Q: What if user forgets both password and email access? A: Only admin can reset via this Users section.
Q: Can I assign multiple roles to one user? A: Yes, select multiple roles in the Advanced tab.
Q: How do I know user status? A: Active column shows a green checkmark for active users.
Q: Can deleted users be recovered? A: No, deletion is permanent unless you have backups.
Q: Why can't I deactivate myself? A: For security, users cannot deactivate or delete their own account.
Q: What happens when I manually set a level? A: The user's level will no longer update automatically based on purchases until you reset to auto mode.
Quick Reference¶
| Field | Tab | Type | Required | Notes |
|---|---|---|---|---|
| Name | Basic | Text | Yes | User full name |
| Basic | Conditional | Based on system settings | ||
| Mobile | Basic | Phone | No | Contact number |
| Date of Birth | Basic | Date | No | For age verification |
| Gender | Basic | Select | No | Male/Female |
| Password | Basic | Password | Create only | Leave empty to keep current |
| Active | Basic | Toggle | Yes | Account status |
| Custom Fields | Custom Fields | Various | Varies | Dynamic based on configuration |
| Loyalty Points | Loyalty | Display | - | Read-only |
| Current Level | Loyalty | Display | - | Read-only |
| Manually Set Level | Loyalty | Select | No | Override auto level |
| Holds Stock | Cart | Toggle | No | Reserve cart items |
| Cart Expiry Override | Cart | Number | No | Days (1-365) |
| Email Verified | Advanced | Toggle | No | Verification status |
| Telegram Chat ID | Advanced | Text | No | For notifications |
| Roles | Advanced | Multi-select | No | Assign permissions |
Related Configuration¶
Configure user registration settings in System Settings:
- Require Email - Make email mandatory during registration
- Require Mobile - Make mobile phone mandatory during registration
- Require Email Verification - Force users to verify email before accessing the app
Related Sections¶
- Roles - Manage user permissions
- User Custom Fields - Add custom user data
- User Levels - Configure loyalty levels
- Loyalty Transactions - View loyalty point history