---
title: Branding
description: Personalizza portale clienti, console e email con nome, logo, colore e valuta — regole di caricamento e dove appare ogni impostazione.
url: https://nexcmp.com/it/docs/customers/branding/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Branding {#branding}

> **Dove si trova nel pannello admin:** System › Settings › Brand (`/settings/branding`). Argomenti correlati: System › Settings › General (`/settings`) per gli URL e i dati del venditore stampati sulle fatture.

## Descrizione {#what-it-does}

NexCMP è una soluzione white-label: il prodotto non riporta alcun nome di fornitore e tutto ciò che i tuoi clienti vedono è il **tuo** marchio. Le impostazioni del brand si applicano alle pagine di accesso e registrazione, al portale, alla console di amministrazione e alle email.

## Requisiti {#requirements}

| Elemento | Requisito |
|---|---|
| Ruolo | Un amministratore. |
| Files | Logos: SVG, PNG, JPEG, WEBP or ICO, **up to 512 KB each**. |
| Dipendenze | Nessuno. |

## Passaggi {#steps}

1. Open **System › Settings › Brand**.
2. Nella scheda **Identity** compila:

   | Campo | Note |
   |---|---|
   | **Brand name** (required) | Fino a 60 caratteri. Mostrato nel portale, nelle email, nelle fatture e nelle pagine legali. |
   | **Nome del venditore sulle fatture** | Fino a 120 caratteri. Se vuoto, viene usato il nome del brand. |
   | **Brand color** | Un colore `#rrggbb`; il piccolo pulsante accanto al campo lo ripristina a quello predefinito. |
   | **Site currency** | **USD**: i prezzi e i saldi sono mostrati solo in USD, senza alcun selettore di valuta. **VND**: mostra anche l'importo convertito al tasso di cambio memorizzato (vedi [Currency and exchange rates](https://nexcmp.com/it/docs/catalog/currency-and-exchange-rates/)). |

3. Clicca su **Save**.
4. Nella scheda **Logo & favicon** carica le tre immagini — **Logo (light background)**, **Logo (dark background)** e **Favicon** — con **Upload** (o **Replace**); **Remove** ne elimina una.

![Pagina del brand con i campi identificativi e le tre immagini caricate](https://nexcmp.com/it/docs/images/customers/branding-01-brand.webp)

### Impostazioni correlate in General {#related-settings-in-general}

**System › Settings › General** ha due schede che completano il quadro:

| Scheda | Campi |
|---|---|
| **Branding & URLs** | Nome del brand (e-mail, fatture), lingua predefinita (inglese o vietnamita), **Customer app URL**, **Console URL**, **Admin URL** (link di impersonificazione del rivenditore) e **Partner console URL** (link di invito, e-mail del rivenditore). La procedura guidata di installazione li riempie con `https://<domain>`, `https://<domain>/admin` e `https://<domain>/console`. |
| **Seller & invoicing** | Nome dell'entità legale, partita IVA, indirizzo, e-mail di contatto e prefisso del numero di fattura. Vedi [Invoices and ledger](https://nexcmp.com/it/docs/billing/invoices-and-ledger/). |

Il nome **From name** delle e-mail è impostato in **System › Settings › Email** ([SMTP and e-mails](https://nexcmp.com/it/docs/administration/smtp-and-emails/)).

## I file caricati vengono controllati {#uploaded-files-are-checked}

- Le immagini raster vengono riconosciute dal loro contenuto (non dal nome del file) e misurate.
- **I file SVG vengono ricostruiti** da un elenco sicuro di forme. Un file contenente script, `foreignObject`, attributi di evento, link esterni, `url(...)` che puntano all'esterno, un DOCTYPE o entità viene **rifiutato** (`svg_unsafe`).
- Un file troppo grande viene rifiutato con `asset_too_large`, un tipo errato con `asset_type`, dimensioni errate con `asset_dimensions`.
- I file vengono serviti dal tuo dominio con intestazioni di sicurezza rigorose.

## Verifica {#verify}

1. Apri la pagina di accesso del portale in una finestra privata: compaiono logo, nome e colore.
2. Controlla la scheda del browser per la favicon (i browser memorizzano nella cache le favicon; ricarica con la cache pulita se vedi ancora quella vecchia).
3. Attiva un'e-mail di test (ad esempio **Send reset link** per un cliente di prova) e controlla il nome del brand nell'oggetto e nel footer.

## Limiti e note {#limits-notes}

- Il logo per lo sfondo scuro viene utilizzato quando il cliente o l'amministratore passa al tema scuro.
- I rivenditori hanno il proprio brand; caricano PNG, JPEG, WEBP o ICO fino a 256 KB (senza SVG). Vedi [Resellers](https://nexcmp.com/it/docs/customers/resellers/).
- Una modifica al colore o al logo del brand viene visualizzata al caricamento della pagina successiva; le e-mail già inviate non vengono modificate.

## Troubleshooting {#troubleshooting}

| Sintomo | Causa | Soluzione |
|---|---|---|
| Caricamento rifiutato: `svg_unsafe` | Il file SVG contiene script, link o riferimenti esterni | Esporta un SVG semplice (senza script, senza immagini esterne) o usa PNG. |
| `asset_too_large` | File superiore a 512 KB | Comprimi o ridimensiona l'immagine. |
| `asset_type` | Non è SVG, PNG, JPEG, WEBP o ICO | Converti il file. |
| `invalid_argument: primary` | Il colore non è `#rrggbb` | Usa un valore esadecimale a sei cifre. |
| Vecchio logo ancora visibile | Cache del browser | Ricaricamento forzato; le favicon possono richiedere più tempo. |
| I prezzi vengono mostrati solo in USD | La valuta del sito è USD | Passa a VND e assicurati che sia memorizzato un tasso di cambio. |