Skip to content

White Label

CxReports supports white labeling so you can replace the CxReports logo with your own across the Reports app. This is useful when CxReports is embedded in a product you ship to your own customers and you want the experience to carry your brand.

License requirement

White label is a premium feature. It is only available on instances whose license has the WhiteLabel premium feature enabled. If your license does not include it, the White Label admin page is hidden and the default CxReports logo is shown everywhere. Contact your account manager if you need this enabled.

Accessing the settings

White label settings are managed by root users only. When the feature is enabled in the license:

  1. Sign in as a root user.
  2. Open System Administration in the main navigation.
  3. Select White Label.

Enabling custom branding

The page exposes two controls:

  • Enable Branding — a toggle that switches the entire instance between the default CxReports branding and your custom branding. Until this is on, the uploaded logo is not displayed anywhere.
  • Company Logo — the logo file shown in the application header, the sign-in page, and the report editor.

To turn on white label:

  1. Upload a logo (see logo requirements below).
  2. Switch Enable Branding on.
  3. Select Save.

The application reloads and the custom logo replaces the CxReports logo. When white label is enabled, a small Powered by Codaxy badge appears in the footer of the main layout.

Logo requirements

The uploaded logo must meet these constraints:

  • File types: PNG, JPEG, SVG, or WebP.
  • Orientation: landscape (wider than tall). Portrait images are rejected with a validation error.
  • Display size: the logo is rendered in a small header bar; aim for an image that reads clearly at roughly 20 pixels in height. SVG is preferred for crisp scaling.

File type and extension are validated both client-side (immediately on upload) and server-side (on save).

To revert to the default CxReports logo:

  1. Open System Administration → White Label.
  2. Select Delete next to the current logo.
  3. Confirm.
  4. Select Save.

Alternatively, switch Enable Branding off — this keeps the uploaded logo on file but shows the default CxReports logo while the toggle is off.

Scope

White label currently affects:

  • The Reports application header logo
  • The sign-in page logo
  • The report editor's left panel footer badge
  • The "Powered by Codaxy" badge in the main layout

It does not currently customize application colors, favicon, or custom CSS. Those may be addressed in future releases.