Branding (KYC)

Location: Settings → Know Your Customer (KYC) → Branding The Branding section lets you create and manage multiple personalization themes for the KYC verification flow. Each theme defines the visual identity shown to end users during verification — logo, colors, font, watermark, and support email. You can apply a different theme per magic link or flow configuration, making it straightforward to serve multiple brands from a single account.

---

​

Managing Themes

Every theme is listed with its Theme ID — the UUID you pass as the theme parameter when generating a token — alongside its internal name and description. Click Create theme to add a new theme. Use the action menu on any existing theme row to edit or delete it.

​

Setting a Default Theme

Open the action menu on a theme row and click Set as default. The theme gets a Default badge in the list, and its action changes to Clear default. Only one theme can be the default at a time, so marking a new one replaces the previous default. The default theme is applied to new sessions that are created without a theme:

• API — a token generated without the theme parameter uses the default theme. Passing theme still applies the theme you name. See Create Verification Session.
• Dashboard — when you turn on the theme option in a form that creates a KYC session, the default theme is pre-selected. This covers New verification, magic links, KYB custom rules and workflows, and the Create KYC token and Generate new token actions on a company page.

Changing the default only affects sessions created afterwards. Sessions that already exist keep their theme. If no theme is marked as default, sessions created without a theme behave as they did before. The default theme can’t be deleted: its delete action is disabled, with the tooltip “Default themes can’t be deleted. Clear default first.” Only team members who can edit themes see Set as default and Clear default.

---

​

Creating or Editing a Theme

A theme is one screen: a Configuration card for the text shown to users, and a UI files card for the visual assets. Theme name is the only required field. Create new theme stays disabled until it is filled in.

​

Filling a Theme from Your Website

Click Add website, enter your domain, and iDenfy reads the site and prefills the theme with the colors and logo it finds. You start from something close to your brand instead of an empty palette.

• Colors and the logo are prefilled wherever they can be detected.
• Fonts are not prefilled. A brand font still has to be uploaded under UI Files, along with a license covering its use.
• Everything prefilled stays editable. Review the values and adjust anything that came out wrong before saving.
• If the site cannot be read, an error is shown and nothing is filled in — set the theme up manually or try a different URL.

Using the banner is optional; a theme can still be built entirely by hand.

​

UI Files

SVG is recommended for the logo — it stays sharp at any size. PNG is accepted at 200 × 200 px minimum. The watermark is applied to the document and selfie photos in the generated verification PDF, not to the verification flow itself.

​

Interface Colors

Click Select colors to open the color picker. Colors are split across two tabs: Main UI colors Other UI colors — Additional interface color overrides. Click Save when done.

​

Preview

Click Preview in the bottom toolbar to see your theme applied to a mock-up of the verification flow on a mobile screen, before saving.

---

​

Assigning a Theme

A theme can be applied in these ways:

• Per magic link — When creating or editing a magic link, enable the Custom theme toggle in the Configuration section and select a theme from the dropdown. See Verification via Magic Link.
• Per flow configuration — Select a theme in the KYC flow settings so every session created with that flow uses the assigned branding automatically.
• Per session through the API — Pass the theme’s ID as the theme parameter when generating a token.

---

​

Texts Shown to Users

A theme changes how the flow looks, not what it says. All texts in the verification flow are predefined and cannot be edited, including translations, titles, descriptions, and status messages. The one text you write yourself is your own privacy and consent text, set on the Privacy Policy tab and shown before the user is asked for a selfie. It works differently from a theme:

• One text per language. You add a separate text for each language. It is set for the whole account, so it cannot vary by country or by session, and it is not part of a theme.
• The user’s language decides. Users see the text for the language they verify in, not the one for their country. If your Czech users must see a Czech consent text, a Czech user who switches the flow to English sees your English text instead. See Localization for how the language is chosen.
• iDenfy’s consent wording is always shown. Your text is added to iDenfy’s standard consent wording, including the biometric consent line. You cannot edit or remove the standard wording.