Every portal has a live branding editor — a what-you-see-is-what-you-get design panel where changes appear instantly in a preview pane on the right. Open it from any portal card via Customise Branding.
Branding is saved per portal. If you want a consistent look across all portals, apply the same settings to each one, or use the tenant-level global default as a starting point.
Changes are only published when you click Save. The live preview reflects your unsaved edits — guests do not see changes until you save.
Upload a logo image (PNG, SVG, or JPEG) to appear at the top of the portal page. You can control:
Choose between a solid colour background or a full-bleed background image:
Pick any colour from the colour picker. Works well for brand-consistent portal designs.
Paste a direct image URL, or use the built-in Unsplash picker (see below) to search for a professional photograph.
QuuPass includes a built-in integration with Unsplash — a library of high-quality, royalty-free photographs. When you select the image background type, a Browse Unsplash button opens a search panel inside the editor.
UNSPLASH_ACCESS_KEY environment variable to be set on the server. Contact your system administrator if the Browse Unsplash button is missing or returns no results.Four independent colours control the visual theme of the portal card overlay:
| Colour | Applied to |
|---|---|
| Primary | Buttons, active states, and primary accent highlights. |
| Secondary | Secondary accents, borders, and subtle UI elements. |
| Background | The portal card background colour — set this to white for a clean card-on-background look. |
| Text | Body text, labels, and instructional copy inside the portal card. |
Choose how the QR code rendered on the portal page looks. Three styles are available, with live mini-previews in the editor:
Standard hard-edged square modules. Maximum scanner compatibility across all devices and QR apps.
Modules with soft, rounded corners. Modern appearance while remaining highly scannable.
Circular dot modules for a distinctive, contemporary aesthetic. Works best with high-contrast colour choices.
An optional heading displayed above the QR code. Use it to greet guests or display venue name: "Welcome to The Grand Hotel" or "Scan to connect to our Wi-Fi".
A free-text area for instructions, brand messaging, or disclaimers. Displayed in a landscape layout beneath the QR code. Useful for adding context like "By connecting you agree to our network usage policy."
Displays a terms acknowledgement line on the portal. You can enter the terms text directly and link to a full external URL (e.g. your venue terms page). Guests see this before receiving their credential.
Displays the plaintext Wi-Fi passphrase below the QR code. Helpful for guests who prefer to type the password manually rather than scan. Disable if you want to keep the passphrase less visible.
The QR code auto-hides itself after a configurable period to deter guests from photographing each other's codes. The default is 15 seconds. Guests can reveal it again by tapping. Adjust this to suit your venue security preference.
Shows or hides the default "How to connect" instruction text that QuuPass includes below the QR code. Disable this if your custom text panel covers the same ground or you prefer a cleaner, minimal design.