Branding.
Customize your installation's name, logo, colors, and identity.
On this page
Set your installation's name, color, and logos from the admin dashboard. Business owners can set their own merchant identity in Business settings.
Configuring branding
- Open Settings → Branding as an administrator.
- Set the application name and primary color.
- Upload logos for light and dark mode.
- Upload a favicon if you want a custom browser-tab icon.
- Select Save changes.
Application name
The application name identifies your installation in its interface and account emails. The default is Rewards. Use a name your members recognize.
Application URL
The application URL is the address used to generate links, including email and QR links. Set it to your installation's address, such as https://rewards.example.com.
Changing this field does not move the website or configure DNS. See Domains, DNS, and HTTPS before moving an installation.
Brand color
Use the color picker or enter a six-digit hex color, such as #8B5CF6. Buttons keep a neutral base with a restrained brand tint. Links, focus indicators, and selected states use related shades.
Check the result in light and dark mode. The interface adapts foreground colors for contrast. No stylesheet build is needed after saving.
Logo
Upload a logo that reads well at a small size. Use a dark logo for light backgrounds and a light version for dark backgrounds.
Supported formats
Logo uploads accept SVG, PNG, JPG/JPEG, and WebP, up to 2 MB. SVG scales without losing detail. PNG and WebP can include transparency.
Fallback behavior
Without a configured logo, the app shows the application name as a text wordmark. The collapsed sidebar uses its initial. Uploaded artwork takes precedence; if only one light or dark logo is supplied, it is used in both modes.
Removing a logo
Select the × on the uploaded logo preview, then Save changes. If the server has a logo default, the app can use that default again.
Favicon
Upload an ICO or SVG file, up to 512 KB. This is the small icon in browser tabs and bookmarks. Use a simple symbol that remains recognizable at that size.
To remove a custom favicon, select × on its preview and save. The default is a neutral wallet mark.
Email branding
Account emails use the application name. Business-related emails use the business identity, including its sender name and reply address. Uploaded application logos do not appear in these email headers.
See Email sender and templates for the exact sender rules.
Partner emails (loyalty, stamps, vouchers, tiers, campaigns)
A partner sets its name and email in Business settings. The sending address remains the installation's configured address.
PWA branding
Open Settings → PWA to configure the installed app's name, icons, and colors. See PWA configuration for these separate controls.
Troubleshooting
| Problem | Check |
|---|---|
| Logo is unclear | Use a simpler image or an SVG source |
| Logo disappears in dark mode | Upload a version that contrasts with a dark background |
| Browser tab still shows the old icon | Refresh the page; the browser may retain its cached favicon |
| An upload fails | Check its format and file size |
| A setting returns to its default | Check whether you selected Reset to default |
Server defaults
Most installations can use the dashboard. Operators who manage server defaults can use .env:
APP_NAME="Your Brand"
APP_URL="https://rewards.example.com"
BRAND_COLOR="#8B5CF6"
APP_LOGO="/files/logo-light.svg"
APP_LOGO_DARK="/files/logo-dark.svg"
Use paths to files that exist on your installation. Uploaded logos take precedence over these defaults. A saved setting that differs from its server default becomes an override. Reset to default removes that override.
After changing .env, refresh the configuration cache from the application directory:
php artisan config:clear
This clears Laravel's cached configuration so it can read the new values. It does not delete uploaded logos or member data.