Skip to main content
ESC

Searching...

Quick Links

Type to search • Press to navigate • Enter to select

Keep typing to search...

No results found

No documentation matches ""

System Settings

Configure platform-wide settings from the admin dashboard

Dec 5, 2025

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

  1. Log in to your admin dashboard
  2. Look for System Settings in the sidebar under the "System" section
  3. Click to open the settings page
  4. 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