Skip to main content
These options are available from v4.6.0 and later and require an Enterprise license with a white-label add-on.
White Labeling Example
White labeling allows you to customize the appearance of your Rallly instance to match your organization’s branding. You can change the application name, primary colors, logos, and hide attribution text.

​
What you can customize

  • App name - The name displayed in page titles, navigation, and emails
  • Primary colors - Brand colors for both light and dark modes
  • Logos - Your own logo for light mode, dark mode, and the icon used in emails
  • Attribution - Hide the “Powered by Rallly” text in polls and emails

​
Configuring branding

Branding is configured from the Control Panel under Branding. Changes take effect immediately, with no restart required.
  1. Sign in as an administrator and go to /control-panel/branding.
  2. Set the app name, primary colors, logos, and attribution settings.
  3. Each field saves on its own, so you can change one setting at a time.
The same settings can also be supplied as environment variables. A value saved in the Control Panel takes precedence over the matching environment variable, and clearing it falls back to the environment variable, then to the Rallly default. Precedence is applied per field, so you can set some values in .env and others in the UI. When a field is backed by an environment variable and has no saved value yet, the Branding page shows a note saying so. Saving a value in the UI overrides it.

​
Logos

The three logo slots serve different purposes:
  • Logo - The wordmark shown on light backgrounds
  • Logo (dark mode) - The wordmark shown on dark backgrounds. Falls back to the light logo if not set
  • Logo icon - A square icon shown at the top of emails
Logo uploads require object storage to be configured. The stack installed by the Rallly CLI includes storage by default, so this works out of the box. If your instance has no storage configured, the Branding page says so and you can point at externally hosted images with LOGO_URL, LOGO_URL_DARK and LOGO_ICON_URL instead. See External object storage for the storage variables. The logo icon is raster only because it is embedded in emails, where SVG rendering is unreliable across mail clients. Removing an uploaded logo clears the saved value, so the instance falls back to the environment variable if one is set, and to the Rallly logo otherwise. There is no logo size setting. On the sign-in and registration pages your wordmark is drawn inside a fixed slot of 192 by 128 pixels, scaled down to fit inside it while keeping its aspect ratio, so it is never cropped or stretched. Elsewhere in the app it is scaled to a fixed height. Because the slot is fixed, the shape of your asset determines how large it renders:
  • Crop the asset tightly to the artwork. Whitespace baked into the file is scaled along with the logo, so a padded asset renders visually smaller than a tight one.
  • Prefer SVG for the wordmark logos so they stay sharp at any size. If you upload a raster wordmark, supply it at roughly twice the slot size so it holds up on high density displays.
  • Wide, horizontal wordmarks fill the slot better than tall or square ones.
  • For the dark mode logo, supply a variant that reads well on a dark background rather than reusing the light one.
The Branding page previews each logo inside the slot it renders in, on the background it will appear against, so you can check the result before rolling it out.

​
Environment variables

Use these when you prefer to configure branding from .env, or when your instance has no object storage for uploads. Add the values to the .env file at the root of your self-hosted stack, then apply them with ./rallly.sh restart.
The three logo variables must be absolute URLs to images your instance can reach. See the Configuration Options page for the full list of available settings.

​
Requirements

  • Enterprise License with White Label Add-on: White labeling features are only available with an active Enterprise license that includes the white label add-on.
  • Without the add-on, the Branding page is read-only and your instance uses the default Rallly branding regardless of any saved or environment variable settings.
To inquire about Enterprise licensing, please fill out our Enterprise Requirements Survey.