Personalizzazione del banner
Modifica layout, colori, testi e lingue del banner di consenso, aggiungi CSS personalizzato, un link alle preferenze e pubblica nuove versioni in sicurezza.
Ultimo aggiornamento: 29 ottobre 2026
In Cookiesh ogni sito ha una sola configurazione del banner. Le regole per regione decidono quale esperienza di consenso riceve un visitatore (opt-in, opt-out o sola informativa), mentre la configurazione del banner decide come appare e cosa dice. Modificala in Banners → Appearance e visualizza l’anteprima delle modifiche dal vivo prima di pubblicarle.
Layout
Scegli il layout più adatto al tuo sito. Ogni layout è disponibile con tema chiaro, scuro e automatico; il tema automatico segue l’impostazione prefers-color-scheme del visitatore.
| Layout | Ideale per | Comportamento |
|---|---|---|
bar |
Siti di marketing | Barra a tutta larghezza nella parte inferiore della finestra |
box |
Siti di contenuti e blog | Scheda compatta in un angolo, non copre i contenuti |
modal |
App che non devono eseguire nulla prima di una scelta | Finestra di dialogo centrata che blocca la pagina finché il visitatore non sceglie |
Tutti i layout riservano il proprio spazio e si caricano dopo i tuoi contenuti, quindi non causano spostamenti del layout. Nei banner opt-in, Rifiuta tutti compare sempre al primo livello, con le stesse dimensioni e lo stesso peso di Accetta tutti. Le autorità considerano un’opzione di rifiuto nascosta un dark pattern, per questo l’impostazione non si può disattivare.
Colori, font e branding
In Appearance → Style puoi impostare:
- Colore del brand. Viene usato per il pulsante principale, gli interruttori e gli indicatori di focus. Cookiesh lo confronta con lo sfondo e ti avvisa se il contrasto è inferiore al livello WCAG AA.
- Font.
inherit(il valore predefinito) usa il font del tuo sito, così il banner sembra nativo senza caricare file aggiuntivi. - Raggio degli angoli e ombra, per adattarli al tuo design system.
- Logo. Facoltativo, viene mostrato nel centro preferenze.
Con i piani Pro ed Enterprise puoi anche rimuovere il badge “Powered by Cookiesh”.
Testi e traduzioni
Cookiesh fornisce testi del banner già revisionati in oltre 40 lingue. Sceglie la lingua in quest’ordine:
- L’attributo
data-languagedel tag script, se presente. - L’attributo
langdel tuo elemento<html>. - La lingua del browser del visitatore.
- La lingua predefinita impostata nella dashboard.
<script
src="https://sdk.cookiesh.eu/v1/consent.js"
data-site-id="ck_live_8f2a91"
data-language="de"
async
></script>
Per cambiare il testo, apri Appearance → Copy, scegli una lingua e modifica titolo, corpo ed etichette dei pulsanti. Le modifiche valgono solo per quella lingua. Usa un testo specifico: indica le finalità (“misurare il traffico”, “mostrare annunci personalizzati”) invece di scrivere “migliorare la tua esperienza”.
CSS personalizzato
Con i piani Pro ed Enterprise, Appearance → Custom CSS ti permette di andare oltre le opzioni integrate. Il banner viene visualizzato all’interno di uno shadow root: gli stili del tuo sito non possono comprometterlo e i suoi stili non possono influire sul tuo sito. Personalizzalo con le proprietà personalizzate CSS e i nomi ::part() esposti:
cookiesh-banner {
--ck-color-primary: #4f46e5;
--ck-color-background: #0a0b10;
--ck-color-text: #ededf2;
--ck-radius: 12px;
--ck-font-family: inherit;
}
cookiesh-banner::part(button-primary) {
text-transform: none;
letter-spacing: 0;
}
cookiesh-banner::part(title) {
font-weight: 600;
}
Parti disponibili: container, title, body, button-primary, button-secondary, link, toggle e category.
Link alle preferenze
I visitatori devono poter cambiare idea con la stessa facilità con cui hanno dato il consenso. Aggiungi al footer un link che riapra il centro preferenze. Funziona qualsiasi elemento con data-cookiesh-open:
<button type="button" data-cookiesh-open="preferences">Impostazioni privacy</button>
Puoi anche chiamare cookiesh.openPreferences() dal tuo codice (vedi l’API JavaScript). Se preferisci non aggiungere un link, attiva il pulsante privacy flottante in Appearance → Floating button.
Pubblicazione e versioni del banner
Le modifiche restano in bozza finché non fai clic su Publish. Ogni pubblicazione crea una nuova versione del banner e ogni record di consenso salva la versione vista dal visitatore, così puoi sempre dimostrare quale testo ha accettato una persona.
Quando modifichi categorie, fornitori o finalità, seleziona Ask again prima di pubblicare. I visitatori che hanno scelto con una versione precedente vedranno di nuovo il banner alla visita successiva. Le modifiche puramente visive, come colori o font, non richiedono una nuova scelta.
Le modifiche pubblicate arrivano sul tuo sito in circa un minuto. Non devi mai rifare il deploy del tuo sito.