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 ""

Branding Settings

Customize application name, logo, and URL

Dec 5, 2025

Your branding settings control how your application appears to users. Set your app name, URL, and logos for both light and dark modes.

Accessing Branding Settings

  1. Navigate to System Settings in the admin sidebar
  2. Click the Branding tab (it's selected by default)

Application Name

The application name appears throughout your platform:

  • Browser page titles
  • Email headers and footers
  • Navigation bars
  • Welcome messages

To set your application name:

  1. Find the Application Name field
  2. Enter your desired name (up to 255 characters)
  3. Keep it concise—ideally under 30 characters for best display

Example: "Acme Rewards" or "Downtown Loyalty Program"

Application URL

This is your primary application URL where users access the platform.

To set your application URL:

  1. Find the Application URL field
  2. Enter your full URL including https://
  3. Don't include a trailing slash

Example: https://rewards.example.com

Important: This URL is used in email links and system notifications. Make sure it's correct and publicly accessible.

Logo Settings

You can set different logos for light mode and dark mode. This ensures your branding looks great regardless of the user's theme preference.

Light Mode Logo

This logo appears when users have light mode enabled (the default for most users).

  1. Find the Logo Light Mode field
  2. Enter the full URL to your logo image
  3. Leave blank if you don't want a custom logo

Best practices:

  • Use SVG format for crisp display at any size
  • Recommended height: 40-60 pixels
  • Ensure the URL is publicly accessible
  • Test on a white or light background

Example: https://cdn.example.com/logos/logo-light.svg

Dark Mode Logo

This logo appears when users enable dark mode.

  1. Find the Logo Dark Mode field
  2. Enter the full URL to your dark mode logo
  3. Leave blank to use the light mode logo for both themes

Best practices:

  • Use a lighter version of your logo for visibility on dark backgrounds
  • Match the dimensions of your light mode logo
  • Test on a dark background before saving

Example: https://cdn.example.com/logos/logo-dark.svg

Logo Preview

After entering logo URLs, you'll see a preview section showing how your logos will appear in both light and dark modes.

Saving Your Changes

Once you've configured your branding:

  1. Review all fields for accuracy
  2. Check the logo previews if you added logos
  3. Click Save Changes at the bottom of the page
  4. Wait for the success message

Your changes take effect immediately. You may need to refresh your browser to see them throughout the application.

Common Issues

Logo Not Displaying

If your logo doesn't appear after saving:

Check the URL is accessible:

  1. Copy the logo URL
  2. Paste it into a new browser tab
  3. Verify the image loads

Possible causes:

  • URL is incorrect or has a typo
  • Image server requires authentication
  • CORS (Cross-Origin Resource Sharing) is blocking the image
  • File doesn't exist at that location

Solution: Use a publicly accessible CDN or hosting service for your logos.

Logo Looks Blurry

Cause: The image resolution is too low for the display size.

Solution: Use SVG format (vector graphics) or provide a high-resolution PNG (at least 2x the display size).

Changes Not Appearing

Cause: Your browser cached the old settings.

Solution:

  1. Hard refresh your browser: Ctrl+Shift+R (Windows/Linux) or Cmd+Shift+R (Mac)
  2. If that doesn't work, clear your browser cache
  3. For persistent issues, run php artisan cache:clear on the server

Related Topics