User Management
Complete guide to managing users in CitoHR, including creating accounts, configuring settings, and managing employee information.
Overview
The User Management section allows administrators to create, edit, and manage all users in the organization. You can configure employment details, leave settings, job history, and more from a centralized location.
Prerequisites
- You must have Admin role to access User Management
- Departments must be set up before assigning users to departments
- Working patterns should be configured if you want to assign them during user creation
Accessing User Management
- Log in to your CitoHR account with Admin credentials
- Click on Admin in the main navigation menu
- Select Users from the admin menu
Screenshot Placeholder
Admin navigation menu showing Users option
/screenshots/docs/features/users/accessing-user-management/screenshot.png
Creating a User
Follow these steps to create a new user account:
- On the Users page, click the "Add User" button in the top right corner
- Fill in the Personal Information section:
- First Name (required)
- Last Name (required)
- Email address (required, must be unique)
- Phone number (optional)
- Configure Employment Details:
- Select a department from the dropdown
- Choose a manager (optional)
- Select the user role (USER, MANAGER, or ADMIN)
- Choose a working pattern if applicable
- Set Account Settings:
- Enter a password (or leave blank to send password reset email)
- Select account status (ACTIVE or INACTIVE)
- Toggle "Send notification email" if you want the user to be notified
- Click "Create User" to save
Warning
Tip
Viewing a User Profile
- Navigate to the Users page
- Click on the user's name in the table
- The user profile will open, showing all available sections in the left sidebar
Adding Jobs to a User
Track job history and position changes for a user:
- Open the user's profile by clicking their name
- Navigate to the "Jobs" tab in the left sidebar
- Click the "Add Job" button
- Fill in the job details:
- Job Title (required)
- Department (required)
- Start Date (required)
- End Date (optional, leave blank for current position)
- Employment Type (Full-time, Part-time, Contract, etc.)
- Salary (optional)
- Click "Save" to add the job entry
Note
Configuring Leave Approvers
Set up who can approve leave requests for a user:
- Open the user's profile
- Navigate to the "Leave" tab
- Scroll down to the "Leave Approvers" section
- Click the "Add Approver" button
- Select an approver from the dropdown menu (shows all users with MANAGER or ADMIN roles)
- Click "Save" to add the approver
- Repeat steps 4-6 to add additional approvers if needed
Tip
Important
Editing User Information
Update user information from the profile page:
- Open the user's profile
- Navigate to the section you want to edit (Personal, Employment, Salary, etc.)
- Click the "Edit" button or click directly on editable fields
- Make your changes
- Click "Save" to apply changes
Searching and Filtering Users
Find specific users quickly:
- On the Users page, locate the search bar at the top
- Type the user's name or email address to search
- Use the Department dropdown to filter by department
- Use the Status filter to show only Active, Inactive, or Pending Approval users
Approving Users
Activate user accounts that are pending approval:
- Navigate to the Users page
- Find users with INACTIVE or PENDING_APPROVAL status
- Click the "Approve" button next to the user's name
- Confirm the approval in the dialog that appears
Warning
Bulk Operations
Perform actions on multiple users at once:
- On the Users page, select multiple users using the checkboxes in the first column
- Click the "Bulk Actions" button that appears
- Choose an action from the dropdown:
- Export - Export selected users to CSV
- Approve - Approve multiple pending users
- Deactivate - Deactivate multiple users
- Delete - Delete multiple users (use with caution)
- Confirm the action in the dialog
Important
Sending Password Reset
- Open the user's profile
- Click the "Send Password Reset" button in the user header section
- Confirm that you want to send the password reset email
- The user will receive an email with instructions to reset their password
Note
Understanding User Statuses
Users can have one of the following statuses:
- ACTIVE - User can log in and use the system normally
- INACTIVE - User account exists but requires admin approval before access
- PENDING_APPROVAL - User has registered but is waiting for admin approval
Related Features
- Organization Management - Learn how to manage departments and organizational structure
- Leave Management - Understand how leave requests work with approvers
- My Profile - See what users can view and edit in their own profiles
