System Settings
Configure platform-wide settings from the admin dashboard
System Settings gives you complete control over your application's branding, email configuration, compliance features, and loyalty card behavior—all from one convenient dashboard.
What You Can Configure
System Settings is organized into four main areas:
| Area | What It Controls |
|---|---|
| Branding | Application name, URL, logos for light and dark modes |
| Email Settings | Sender name and email address for all notifications |
| Compliance | Cookie consent banners and privacy features |
| Loyalty Cards | Redemption codes, member limits, staff visibility settings |
Who Can Access This
Only Super Administrators (the highest admin role) can view and modify system settings. This ensures critical configuration stays protected.
How Settings Work
Settings you configure here take priority over everything else:
| Priority | Source | Description |
|---|---|---|
| 1 (Highest) | Database settings | What you set in System Settings |
| 2 | .env file values |
Server configuration |
| 3 (Lowest) | Default configuration | Built-in defaults |
Once you save a setting in the dashboard, it overrides any defaults or environment variables.
Accessing System Settings
- Log in to your admin dashboard
- Look for System Settings in the sidebar under the "System" section
- Click to open the settings page
- Use the tabs at the top to navigate between areas
Configuration Areas
Branding Settings
Customize your application's appearance:
- Application name
- Site URL
- Light mode logo
- Dark mode logo
- Favicon
See Branding Settings for details.
Email Settings
Configure email delivery:
- Sender name (e.g., "Your Company")
- Sender email address
- Reply-to address
See Email Settings for details.
Compliance Settings
Manage privacy and legal requirements:
- Cookie consent banner
- Privacy policy links
- Terms of service links
- GDPR compliance features
See Compliance Settings for details.
Loyalty Card Settings
Control card behavior:
- Redemption code options
- Member limits
- Staff visibility settings
- Default card settings
See Loyalty Card Settings for details.
Key Concepts
Configuration Hierarchy
Your application pulls settings from three places. The database (System Settings) always wins. If a setting isn't in the database, the app checks your .env file. If it's not there either, it uses the built-in defaults.
Demo Mode Protection
If your application is running in demo mode (APP_DEMO=true), you won't be able to save or reset settings. This protects demo installations from being modified.
Audit Logging
Every change you make is automatically logged. You can see:
- Who changed what
- When they changed it
- Old and new values
This creates a complete audit trail for compliance and troubleshooting.
Related Topics
- Branding Settings — Customize appearance
- Email Settings — Configure email delivery
- Compliance Settings — Privacy and legal
- Loyalty Card Settings — Card behavior
- Settings Troubleshooting — Fix common problems