Vinc Guide
Sign in
Guide / For Administrators / Branding & White-Label

Make it look like your product.

Set a brand name and logo once; it propagates to every user-facing surface — emails, dashboards, public vCard pages, the Apps grid tile.

01Where to set it

Open Settings from the main app menu. Scroll the left rail until you find the Vinc section — there's one block, "Branding", with four fields:

  • Brand Name — full product name, used in prose. Default: "Vinc".
  • Short Name — compact version for tight spaces (logo chips, wordmarks). Default: "Vinc".
  • Brand Icon — square logo (~512×512 PNG). Used for chips, favicons, the Apps grid tile, and the default QR-code center overlay.
  • Brand Wordmark — horizontal logo for page headers and email banners. Falls back to the icon if blank.

Save the form. Hard-refresh the browser (Ctrl+Shift+R / Cmd+Shift+R) and the new branding shows up everywhere immediately.

02What rebrands

  • The Apps grid tile — the icon and label on the main Apps menu use your uploaded values.
  • Top-level menu — the app's root menu name and icon (the one between the chatter and the screen).
  • Public vCard pages — magic-link onboarding, NFC setup wizard, vCard form headers, the Vinculum Guide top bar — all read the brand name at render time.
  • Email subjects and bodies — bulk-onboarding "your card is ready" email, weekly digest footer. Each email reads the brand from ir.config_parameter at send time, so a brand change applied today retroactively rebrands tomorrow's emails without resending.
  • QR code center overlay — when a card hasn't uploaded its own QR logo, the overlay defaults to your Brand Icon.

03What stays "Vinc"

A few surfaces are deliberately not rebrandable, by design or by Odoo constraint:

  • The technical module name (qr_code_odoo) — internal identifier, never user-visible.
  • Email template names in Settings → Technical → Email Templates — they still show as Vinc — Digest Email etc. because admins use those names to find templates. The bodies rebrand; the labels don't.
  • App-store listing (the static/description/index.html rendered on apps.odoo.com) — that's the marketing page for the public Vinc product, not a per-tenant surface.

04Persistence across upgrades

Odoo's standard behavior on module upgrade is to re-import data files, which would normally reset the menu's name and icon back to the bundled defaults. Vinc hooks into Odoo's registry-load step to re-apply your saved brand on every server start, so a future -u qr_code_odoo doesn't undo your customization. The brand-name and short-name strings live in ir.config_parameter; the icon and wordmark binaries live in ir.attachment.

Smoke test after upgrades: hard-refresh the Apps grid. If the tile reverts to the default icon, do Settings → Vinc → Save once and refresh again — that re-fires the sync method that talks to the menu/module records.