The Settings section allows administrators to configure global application behavior, company information, and system preferences. This guide covers all major configuration areas.
Accessing Settings
Navigate to Settings from the main menu. Settings are organized into logical categories for easy navigation.
Most settings require Admin or Super Admin role to view and modify.
Basic Company Details
Configure your organization's identity:
| Setting | Description |
|---|
| Company Name | Your organization's legal name |
| Company Short Name | Abbreviated name for display |
| Company Logo | Logo displayed throughout the application |
| Favicon | Browser tab icon |
| Company Website | Your corporate website URL |
| Company Email | Primary contact email |
| Company Phone | Main phone number |
Company Address
| Setting | Description |
|---|
| Address Line 1 | Street address |
| Address Line 2 | Suite, floor, building |
| City | City name |
| State/Province | State or province |
| Postal Code | ZIP or postal code |
| Country | Country selection |
Registration Details
| Setting | Description |
|---|
| Registration Number | Business registration/incorporation number |
| Tax ID | Tax identification number |
| VAT Number | Value-added tax number (if applicable) |
Date & Time Settings
Choose how dates are displayed throughout the system:
| Format | Example |
|---|
| DD/MM/YYYY | 25/12/2025 |
| MM/DD/YYYY | 12/25/2025 |
| YYYY-MM-DD | 2025-12-25 |
| DD-MMM-YYYY | 25-Dec-2025 |
| Custom | Configure your own format |
| Format | Example |
|---|
| 12-hour | 2:30 PM |
| 24-hour | 14:30 |
Timezone
- Select your organization's primary timezone
- Affects all time-based calculations
- Attendance, leave, and scheduled tasks use this setting
Week Start Day
| Option | Common Usage |
|---|
| Sunday | Americas, some Asian countries |
| Monday | Europe, most of the world |
| Saturday | Middle East |
Financial Year
Configure your fiscal year:
| Setting | Description |
|---|
| Start Month | Month when your financial year begins |
| Leave Year Start | Month when leave balances reset |
Currency Settings
Primary Currency
| Setting | Description |
|---|
| Currency | Select from list (USD, EUR, GBP, etc.) |
| Currency Symbol | Symbol displayed (e.g., $, €, £) |
| Symbol Position | Before or after the amount |
| Decimal Places | Number of decimal digits (usually 2) |
| Thousand Separator | Character for thousands (comma or period) |
| Decimal Separator | Character for decimals (period or comma) |
Multi-Currency Support
If enabled:
- Define additional currencies
- Set exchange rates
- Configure automatic rate updates
| Configuration | Display |
|---|
| USD, Symbol before, comma separator | $1,234.56 |
| EUR, Symbol after, period separator | 1.234,56 € |
| INR, Symbol before, Indian numbering | ₹1,23,456.00 |
Email Configuration
SMTP Settings
Configure email delivery:
| Setting | Description |
|---|
| SMTP Host | Mail server address (e.g., smtp.gmail.com) |
| SMTP Port | Server port (usually 587 or 465) |
| SMTP Username | Email account username |
| SMTP Password | Email account password or app password |
| Encryption | TLS or SSL |
| From Address | Default sender email |
| From Name | Default sender name |
Testing Email
- Configure SMTP settings
- Click Send Test Email
- Enter a test recipient
- Check inbox for test message
- Verify email was received
Email Templates
Customize system email templates:
- Welcome email for new employees
- Leave request notifications
- Approval confirmations
- Password reset emails
- System alerts
Notification Settings
Notification Channels
Configure available notification methods:
| Channel | Description |
|---|
| Email | Traditional email notifications |
| Push | Mobile app push notifications |
| In-App | Browser notifications |
| SMS | Text message alerts (if configured) |
Default Notifications
Set which events trigger notifications:
| Event | Recipients | Channels |
|---|
| Leave Request | Manager | Email, Push |
| Leave Approved | Employee | Email, Push, In-App |
| Attendance Alert | HR | Email |
| Task Assigned | Assignee | Push, In-App |
| Birthday | Team | In-App |
Notification Scheduling
| Setting | Description |
|---|
| Digest Mode | Combine notifications into daily digest |
| Quiet Hours | Suppress notifications during set hours |
| Frequency Limits | Prevent notification flooding |
Map Settings
For location-based features:
Map Provider
| Provider | Use Case |
|---|
| Google Maps | Most feature-rich, requires API key |
| OpenStreetMap | Free, no API key required |
| Mapbox | Good alternative to Google |
Google Maps Configuration
| Setting | Description |
|---|
| API Key | Your Google Maps API key |
| Default Location | Center point for map views |
| Default Zoom | Initial zoom level |
Geofencing Settings
For attendance and tracking:
| Setting | Description |
|---|
| Enable Geofencing | Restrict check-in to specific locations |
| Office Locations | Define office coordinates |
| Geofence Radius | Acceptable distance from location (meters) |
Attendance Settings
General Settings
| Setting | Description |
|---|
| Attendance Mode | Web, Biometric, Mobile, or All |
| IP Restriction | Limit check-in to specific IP ranges |
| Device Restriction | Limit to registered devices |
| Photo Required | Require selfie for check-in |
Late/Early Rules
| Setting | Description |
|---|
| Late Mark After | Minutes after shift start to mark late |
| Early Leave Mark | Minutes before shift end for early leaving |
| Half Day Threshold | Hours worked to count as half day |
| Absent Threshold | Hours below which is marked absent |
Overtime Settings
| Setting | Description |
|---|
| Enable Overtime | Track overtime hours |
| Overtime After | Hours after which overtime begins |
| Overtime Rate | Multiplier for overtime pay |
| Maximum Overtime | Daily overtime limit |
Leave Settings
General Leave Settings
| Setting | Description |
|---|
| Leave Year Start | Month when leave year begins |
| Weekend Inclusion | Include weekends in leave count |
| Holiday Inclusion | Include holidays in leave count |
| Minimum Leave | Smallest leave unit (full day, half day) |
Approval Settings
| Setting | Description |
|---|
| Auto-Approve | Enable automatic approval conditions |
| Approval Levels | Number of approval levels required |
| Escalation | Auto-escalate pending requests |
Balance Display
| Setting | Description |
|---|
| Show Carryover | Display carried over balance separately |
| Show Used | Display used leave count |
| Show Pending | Display pending requests in balance |
Payroll Settings
Salary Components
Configure how salaries are structured:
| Component Type | Examples |
|---|
| Earnings | Basic, HRA, Transport Allowance |
| Deductions | Tax, PF, Insurance |
| Reimbursements | Medical, Travel |
Calculation Settings
| Setting | Description |
|---|
| Days in Month | Fixed (30) or Calendar days |
| LOP Calculation | How unpaid leave is deducted |
| Pro-rata | Calculate for partial months |
Statutory Compliance
Configure based on your location:
| Setting | Description |
|---|
| Tax Calculation | Tax slab configuration |
| Provident Fund | PF contribution rules |
| Social Security | Social security deductions |
Security Settings
Password Policy
| Setting | Description |
|---|
| Minimum Length | Required password length |
| Complexity | Require mixed case, numbers, symbols |
| Expiry | Force password change after X days |
| History | Prevent reusing recent passwords |
Session Settings
| Setting | Description |
|---|
| Session Timeout | Auto-logout after inactivity |
| Concurrent Sessions | Allow multiple active sessions |
| Remember Me Duration | How long to keep sessions alive |
Two-Factor Authentication
| Setting | Description |
|---|
| Enable 2FA | Make two-factor available |
| Require for Admins | Mandatory for admin accounts |
| 2FA Methods | Authenticator app, SMS, Email |
Localization
Language Settings
| Setting | Description |
|---|
| Default Language | System default language |
| Available Languages | Languages users can choose |
| RTL Support | Enable right-to-left for Arabic, Hebrew |
Regional Settings
| Setting | Description |
|---|
| Number Format | Thousand/decimal separators |
| Phone Format | Default phone number format |
| Address Format | Address display order |
System Settings
Maintenance Mode
| Setting | Description |
|---|
| Enable Maintenance | Show maintenance page to users |
| Maintenance Message | Custom message during maintenance |
| Allow IP | IPs that can access during maintenance |
Backup Settings
| Setting | Description |
|---|
| Auto Backup | Enable scheduled backups |
| Backup Frequency | Daily, Weekly, Monthly |
| Backup Retention | How long to keep backups |
| Backup Storage | Local or cloud storage |
| Setting | Description |
|---|
| Cache Duration | How long to cache data |
| Pagination | Default items per page |
| File Upload Limit | Maximum upload size |
Saving Settings
Save and Apply
- Make your changes
- Click Save Settings
- Some settings apply immediately
- Others may require cache clear or restart
Cache Clear
After changing certain settings:
- Navigate to Settings > Cache
- Click Clear Cache
- Or run via command line:
php artisan cache:clear
Best Practices
Initial Setup
- Configure company information first
- Set date/time/currency preferences
- Configure email for notifications
- Set up security policies
- Enable required modules
Regular Maintenance
- Review settings quarterly
- Update exchange rates if multi-currency
- Audit security settings
- Check backup status
Documentation
- Document custom configurations
- Note any deviations from defaults
- Keep credentials secure
- Maintain change log
This completes the User Guide section. For module-specific configuration, see the Modules documentation.