Skip to main content

Branding

[branding] [admin]

Complete white-label branding of your provider portal: colors, logo, font, login texts. Applies to the portal, the landing page and the widget.

Who it is for​

Admins who want to run their portal in the corporate identity of their brand.

What you can customize​

Colors and fonts​

8 color variables plus two font fields:

  • primary_color: primary (buttons, links, accents)
  • background_color: main page background
  • header_color: header background
  • sidebar_color: sidebar background
  • text_color: general text color
  • button_text_color: text on buttons (e.g. white on primary)
  • heading_color: headings (h1, h2, h3)
  • body_text_color: body text color
  • font: Google font name (loaded live, e.g. "Inter", "Roboto", "Poppins")
  • font_secondary: alternative font for headlines

Font​

Google Fonts API. Entered as a string: "Inter", "Roboto Condensed", "Playfair Display" etc. Live preview in the branding tab.

Logo & favicon​

Upload via the storage bucket tenant-assets. Path: <tenant_id>/branding/logo.{jpg,png,svg}. The favicon is injected dynamically into the <head> via generateMetadata().

Login texts​

  • login_title (e.g. "Welcome back")
  • login_subtitle (e.g. "Sign in with your license account")

Button style​

  • button_style: rounded (default, 9px radius), square (0px), pill (999px)

Support email​

  • support_email: used as the recipient for forwarded tickets and the footer contact link

Company name​

  • company_name: if it differs from tenant.name. Used in the footer, the Stripe vendor and the mail sender

Invoicing​

Separate "Invoicing" tab, see Invoicing.

Step by step​

1. Open the branding tab​

Settings → Branding.

2. Set the colors​

9 color pickers: every change is visible live in the mobile/desktop preview on the right.

Upload logo → JPG/PNG/SVG. Recommended: SVG for crisp scaling.

4. Upload the favicon​

Upload favicon → PNG (32x32 or 64x64).

5. Choose a font​

Enter a Google font name. The preview shows immediately how it looks.

6. Personalize the login texts​

"Welcome to {brand}" or similar.

7. Save​

Click Save: it takes effect immediately on the portal, landing page and widget.

Mobile preview​

The branding tab has a built-in mobile preview (an embedded iframe) that shows your login screen with the current colors and logo. A toggle for the desktop view is there as well.

Frequently asked questions​

Will existing customers see the new colors immediately? Yes: branding is loaded live from the DB, not built statically.

What if I need several brand variants? licensio currently supports one branding per provider. If you have several brand identities (parent and subsidiary brand), you need separate providers.

Do I have to optimize SVG logos? Preferably yes. Very large SVGs can affect load times. For PNG: max 200 KB.

How does the branding reach the emails? Resend templates currently only inherit primary_color as an accent color. The logo is embedded statically. Full HTML branding of the emails is coming in Phase 2.

How does branding differ from the widget tab? Branding applies to the portal, landing page and emails. The widget tab has its own configuration specifically for the embeddable button (its own color, style, size and text). If the widget tab has no values set, it falls back to branding.primary_color etc.

Related​

  • Widget: how the button on an external page uses the branding
  • Custom Domain: portal under your own domain — in preparation (ships with white-label)
  • Invoicing: invoice logo and company data