Branding configuration
Self-service branding configuration is on the LuxID roadmap. Today, branding assets (logo, display name, description, language variants) are uploaded by LuxID when you submit them to LuxID. The field list below describes what to include in your request.
What you can customise
LuxID allows per-Application branding on two surfaces: the consent screen and, to a limited extent, certain transitions on the login screen.
The scope of customisation is intentionally narrow. The login screen itself remains LuxID-branded - users must always be able to recognise that they are authenticating with LuxID, not with the Partner application. This is a deliberate trust design: users who see the LuxID login page should know they are on LuxID, regardless of which Partner sent them there.
Within that constraint, the following elements are configurable:
| Element | Surface | Configurable |
|---|---|---|
| Application logo | Consent screen | Yes |
| Application display name | Consent screen | Yes (localised per language) |
| Application short description | Consent screen | Yes (localised per language) |
| Brand colour accent | Consent screen (limited) | Yes - single hex colour |
| Login page header | Login screen | No - LuxID-branded only |
| Login page background | Login screen | No |
| Login page button styles | Login screen | No |
For guidance on login button guidelines for your own application (outside the LuxID-hosted page), see Login button guidelines.
Application logo
Requirements
| Attribute | Requirement |
|---|---|
| Format | PNG or SVG |
| Minimum dimensions | 256 x 256 px |
| Aspect ratio | Square preferred; landscape accepted. Portrait logos are cropped to square. |
| Maximum file size | 512 KB |
| Background | Transparent or white |
| Colour space | sRGB |
The logo is rendered at approximately 64 x 64 px on the consent screen on desktop, and smaller on mobile. Before uploading, confirm that your logo is legible and recognisable at these sizes. A wordmark that reads well at 300 px may become illegible at 64 px - use an icon or monogram variant for small-size display.
Avoid logos with fine detail, thin lines, or very light colours that disappear on a white background.
Uploading the logo
- Log in to the Console at https://console.luxid.lu (opens in a new tab).
- Navigate to Applications and select your Application.
- Select the Branding tab.
- Under Application Logo, select Upload.
- Choose your PNG or SVG file.
- The Console displays a preview of the logo at consent-screen size. Confirm it is legible, then select Save.
Changes take effect on the next user-facing consent prompt. Existing sessions are not affected.
Application display name and short description
Display name
The display name is the name shown in the heading of the consent screen. By default it is the Application Name set at registration. You can override it here with a more user-friendly label.
The display name is used in consent screen copy such as:
[Application Display Name] is requesting access to your LuxID profile.
Keep it short - 30 characters or fewer work best on mobile consent screens.
Short description
The short description (under 200 characters) appears below the display name on the consent screen. It should answer the user's implicit question: "What is this application and do I recognise it?"
Example:
MyPost lets you track your parcels, manage subscriptions, and access POST Luxembourg services.
Write for end users, not for developers. Avoid technical jargon.
Localised display names and descriptions
LuxID supports four languages for consent screen copy: English (en), French (fr), German (de), and Luxembourgish (lb).
For each language, you can provide a localised display name and short description. LuxID selects the language to display based on the user's language preference set in their LuxID Account. If a language is not configured, LuxID falls back to the English values.
To configure localised values:
- In the Branding tab, select the language tab (
en,fr,de,lb). - Enter the display name and short description for that language.
- Select Save for each language.
If your application serves a primarily Francophone or Luxembourgish-speaking audience, French and Luxembourgish translations are particularly important. Users whose language is not covered see English, which may feel impersonal.
Brand colour accent
You can specify a single hex colour code that LuxID uses as an accent on the consent screen - for example, as a border or highlight around your Application logo.
Enter the value as a six-digit hex code (for example, #003087 for POST blue). The Console validates that the colour meets a minimum contrast ratio against the consent screen background for accessibility purposes. Very light colours (close to white) or colours with insufficient contrast will be rejected.
This accent colour applies to the consent screen only. It does not carry through to the LuxID login page.
Previewing the consent screen
Before going live, use the Consent Simulator to preview how the consent screen will appear to users. The simulator shows the full consent screen with your logo, display name, description, and colour accent applied, in each configured language.
Access the Consent Simulator from:
- The Branding tab of your Application, via the Preview button.
- The Testing and Tooling section of the Console - see Testing and tooling.
The Consent Simulator does not initiate a real authentication flow. It renders a static preview from your current saved configuration.
Review the preview in all languages you have configured. Check that the logo is legible, the text is grammatically correct, and the colour accent looks appropriate.
Branding in UAT vs production
Branding configuration is independent per environment. If you upload a logo in UAT, you must also upload it in Production after promotion. There is no automatic copy.
Use UAT branding to test and approve the consent screen design before going live. Treat the Production branding configuration as a deliberate, reviewed step in your go-live checklist.
Common mistakes
- Uploading a high-resolution marketing logo that becomes illegible at 64 x 64 px. Use an icon variant.
- Forgetting to configure localised names for French or Luxembourgish, resulting in English-only consent screens for most Luxembourgish users.
- Setting a very light brand colour that disappears on the white consent screen background.
- Configuring branding only in UAT and forgetting to replicate it in Production at go-live.