System Settings.
Overview of platform-wide settings in the admin dashboard
System Settings gives you complete control over your application's branding, member experience, email configuration, compliance features, and loyalty card behavior—all from one convenient dashboard.
Accessing System Settings
- Log in to your admin dashboard
- Navigate to Settings in the admin sidebar
- Use the tabs at the top to navigate between areas
Who Can Access This
Only Super Administrators (the highest admin role) can view and modify system settings. This ensures critical configuration stays protected.
Configuration Areas
System Settings is organized into seven tabs:
| Tab | What You Configure |
|---|---|
| Branding | Application name, URL, brand color, logos, favicon |
| Homepage | Public landing page layout style |
| Onboarding | Anonymous member mode and settings |
| Compliance | Cookie consent banner (GDPR) |
| Email Settings | Sender name and email address |
| Loyalty Cards | Redemption codes, member limits, staff visibility |
| PWA | Progressive Web App settings and icons |
Tab Overview
Branding
Customize your application's identity and appearance.
| Setting | Purpose |
|---|---|
| Application Name | Appears in browser tabs, emails, and system messages |
| Application URL | Base URL for email links and QR codes |
| Primary Color | Brand color used for buttons, links, and accents. Also used as the browser theme color. |
| Light Mode Logo | Logo displayed on light backgrounds |
| Dark Mode Logo | Logo displayed on dark backgrounds (optional) |
| Favicon | Custom icon displayed in browser tabs, bookmarks, and history |
Logo Guidelines:
- SVG format recommended for crisp scaling
- Horizontal logos work best (max 200×60px display)
- Use transparent backgrounds when possible
- Both PNG and JPG are supported (max 2MB)
Favicon Guidelines:
- Accepted formats:
.ico(traditional) or.svg(modern, scalable) - Max file size: 512KB
- If no custom favicon is uploaded, the default
favicon.icois used - The brand color is automatically applied as the browser theme color
Homepage
Configure how visitors experience your public landing page.
| Layout Style | Best For |
|---|---|
| Smart Wallet | Multi-partner networks. Shows loyalty programs from multiple partners in one unified wallet. |
| Showcase | Single businesses. Editorial presentation with featured programs. |
| Portal | QR-driven flows. Minimal sign-in focused landing. |
Full guide: Homepage Layout
Onboarding
Configure how new members join and interact with your loyalty programs.
Anonymous Members
Enable zero-friction onboarding for visitors.
| Setting | Purpose |
|---|---|
| Enable anonymous mode | Visitors can use loyalty features instantly without registering. A member account is automatically created and linked to their device. |
| Also log out anonymous members | End all sessions for members who haven't added an email address. Only available when disabling anonymous mode. |
| Member code length | Each anonymous member gets a unique code. Shorter codes look friendlier, longer codes support more members. |
How it works: Visitors become members instantly — no signup required. They can earn points, collect stamps, and claim rewards right away. To access their account on other devices or receive emails, they can add an email address at any time.
Full guide: Anonymous Members
Compliance
Privacy and regulatory compliance settings.
| Setting | Purpose |
|---|---|
| Enable Cookie Consent Banner | Show or hide the cookie consent banner on the frontend |
GDPR & Privacy Compliance: When enabled, visitors will see a cookie consent banner before any tracking cookies are set. This helps ensure compliance with GDPR and similar privacy regulations.
Full guide: Cookie Consent & Compliance
Email Settings
Configure how emails are sent from your application.
| Setting | Purpose |
|---|---|
| Mail From Name | The name that appears as the sender of outgoing emails (e.g., "Reward Loyalty") |
| Mail From Address | The email address used as the sender for outgoing emails |
A live Email Preview shows how emails will appear to recipients.
Note: SMTP and email provider settings must be configured in
.env. See Email Configuration for provider-specific setup.
Loyalty Cards
Control loyalty program behavior, limits, and security settings.
Member Settings
| Setting | Purpose |
|---|---|
| Max Member Request Links | The maximum number of point request links a member can generate |
Redemption Settings
| Setting | Purpose |
|---|---|
| Reward Claim QR Expiry | How long a member's reward claim QR code stays valid. Shorter times protect against replay attacks. |
| Redemption Code Validity | How long a staff-generated 4-digit redemption code is valid |
Staff Settings
| Setting | Purpose |
|---|---|
| Staff Transaction Visibility (Days) | Number of days a staff member can see members they interacted with in their dashboard |
Privacy & Security Notice: This setting helps protect member privacy by limiting how long staff can view member interaction history. Lower values improve privacy but may reduce staff efficiency.
Full guide: Loyalty Cards Settings
PWA
Configure installable app settings and icons for the Progressive Web App.
HTTPS Required: PWA features require HTTPS (SSL certificate) to work properly.
| Setting | Purpose |
|---|---|
| App Name | Full name shown in install prompts |
| Short Name | Shown on home screen (max 12 characters) |
| Description | Brief description shown when installing the app (keep under 132 characters) |
| Theme Color | Browser toolbar color |
| Background Color | Splash screen background |
App Icons
Upload square PNG images for home screen and app drawer. Icons will be automatically resized.
| Size | Purpose |
|---|---|
| 192×192 Icon | Used for home screen on mobile devices |
| 512×512 Icon | Used for app drawer and splash screen |
Icon Guidelines:
- Use square images (1:1 aspect ratio)
- PNG format recommended for best quality
- Solid background color works best (avoid transparency)
- Use your brand colors and logo
Full guide: PWA Configuration
How Settings Work
Settings you configure here take priority over everything else:
| Priority | Source | Description |
|---|---|---|
| 1 (Highest) | Dashboard 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.
Tip: Use the dashboard for settings you want to manage easily. Use
.envfor settings you want to lock in at the server level.
Key Concepts
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. The system records:
- Who changed what
- When they changed it
- Old and new values
This creates a complete audit trail for compliance and troubleshooting. See Activity Logs for more details.
Related Topics
- Anonymous Members — Zero-friction onboarding
- Homepage Layout — Smart Wallet, Showcase, and Portal layouts
- Branding — Name, logo, and URL configuration
- Email Configuration — Sender settings and SMTP providers
- Cookie Consent & Compliance — Privacy and GDPR settings
- Loyalty Cards Settings — Card behavior and limits
- PWA Configuration — Progressive Web App settings
- Activity Logs — View all setting changes