Personalizza il tema e l'immagine coordinata di Element Web

Per un'installazione self-hosted di Element Web, imposta il nome dell'app e il tema predefinito nel suo file config.json, quindi utilizza le brandingopzioni documentate per il logo di accesso, lo sfondo, il link al logo e i link del piè di pagina. Per i colori personalizzati, definisci un tema in setting_defaults.custom_themese specifica default_themeil suo custom-nome. Queste impostazioni personalizzano Element, ma non lo trasformano in un prodotto completamente white-label.

Scopri quali controlli di branding ti servono

La configurazione di Element separa l'identità del prodotto, i temi di colore e le risorse della pagina. Scegli la modifica più piccola che ti permetta di raggiungere il tuo obiettivo:

ObiettivoConfigurazioneCosa cambia
Mostra il nome del tuo serviziobrandNome dell'app in varie stringhe e posizioni
Imposta un tema iniziale chiaro, scuro o personalizzatodefault_themeTema di colori predefinito per la distribuzione
Modifica l'aspetto della schermata di accesso e di benvenutobrandingLogo della pagina di autenticazione, sfondo, link al logo e link a piè di pagina
Imposta colori e caratteri personalizzatisetting_defaults.custom_themesOpzioni del tema come token di colore e famiglie di caratteri

Verificato: la documentazione di Element afferma che supporta alcune personalizzazioni, ma non il rebranding completo o l'etichettatura privata. Implicazione pratica: le modifiche brandnon sostituiranno ogni logo, icona, immagine o riferimento al prodotto. Se è necessario modificare ogni elemento visivo e stringa, è consigliabile mantenere una build personalizzata e ricontrollarla dopo gli aggiornamenti. Iniziate elencando gli elementi dell'interfaccia utente che i vostri utenti devono visualizzare prima di optare per un approccio basato esclusivamente sulla configurazione.

Aggiornare la configurazione distribuita in modo sicuro

Element Web viene letto config.jsonall'avvio. Esegui un backup del file corrente e modificalo direttamente per mantenere le impostazioni necessarie, come ad esempio il server home predefinito. Per un tarball di rilascio, il file si trova nella directory web distribuita; il pacchetto Debian utilizza /etc/element-web/config.json. Con Docker, monta la tua configurazione in /app/config.json. La posizione corretta dipende da come hai installato Element, quindi verifica il tuo metodo di distribuzione prima di modificarlo.

Aggiungi le seguenti chiavi all'oggetto JSON esistente, combinandole con le impostazioni già presenti. Non incollare questo testo in sostituzione dell'intera configurazione:

{
  "brand": "Northstar Chat",
  "default_theme": "dark",
  "permalink_prefix": "https://chat.example.org",
  "branding": {
    "logo_link_url": "https://example.org",
    "auth_header_logo_url": "https://chat.example.org/assets/logo.svg",
    "welcome_background_url": "https://chat.example.org/assets/welcome.jpg",
    "auth_footer_links": [
      { "text": "Help", "url": "https://example.org/help" },
      { "text": "Privacy", "url": "https://example.org/privacy" }
    ]
  }
}

Sostituisci il nome di esempio, i nomi host e le risorse con i tuoi. brandModifica il nome dell'app in vari punti; permalink_prefixfa sì che i permalink condivisi puntino alla tua distribuzione Element anziché matrix.toa . Il logo e le voci di sfondo sono URL caricati dal browser. Servili tramite HTTPS da una posizione raggiungibile dai tuoi utenti e verifica che i controlli di accesso, la policy di sicurezza dei contenuti e la cache non li blocchino. La documentazione non specifica una dimensione universale per l'immagine del logo di autenticazione, quindi visualizza in anteprima la risorsa effettiva anziché presumere una dimensione fissa.

Dipende dall'implementazione: un file di configurazione influisce sull'istanza di Element Web che lo gestisce. Non modifica il app.element.ioservizio ufficiale né cambia automaticamente le app separate di Element per dispositivi mobili o desktop. Apporta la modifica sull'host o sul container che ospita la tua istanza.

Aggiungi un tema di colori personalizzato

Per un tema semplice di colori e caratteri, Element documenta le definizioni del tema personalizzato all'interno di setting_defaults.custom_themes. Il nome interno del tema è preceduto da custom-; usa quel nome completo in default_theme. Questo esempio mostra un tema personalizzato compatto. È un punto di partenza, non una tavolozza completa:

{
  "default_theme": "custom-Northstar",
  "setting_defaults": {
    "custom_themes": [
      {
        "name": "Northstar",
        "is_dark": false,
        "fonts": {
          "general": "Inter, sans-serif",
          "monospace": "'Courier New'"
        },
        "colors": {
          "accent-color": "#3157A4",
          "primary-color": "#3157A4",
          "warning-color": "#B5473C",
          "sidebar-color": "#202A3B",
          "roomlist-background-color": "#F3F5F8",
          "roomlist-text-color": "#202938",
          "timeline-background-color": "#FFFFFF",
          "timeline-text-color": "#202938"
        }
      }
    ]
  }
}

Integra queste chiavi nel tuo JSON esistente anziché creare un secondo setting_defaultsoggetto. Mantieni un contrasto leggibile tra testo, sfondi e controlli sia in modalità normale che evidenziata. Il riferimento al tema di Element include colori opzionali aggiuntivi, array di colori per nome utente e avatar, font personalizzati e token di progettazione Compound. Aggiungi solo i valori che hai esaminato nel riferimento corrente; una tavolozza incompleta potrebbe lasciare alcune parti dell'interfaccia con i valori predefiniti.

Un malinteso comune: l'impostazione default_themesceglie il valore predefinito per la distribuzione; la documentazione non la descrive come una policy che blocca le impostazioni di aspetto di ogni utente. Se hai bisogno di un tema rigorosamente applicato, verifica questo comportamento con la versione esatta di Element Web che utilizzi, invece di presumere che l'impostazione predefinita sia un blocco.

Applica la modifica e verifica il risultato

  1. Prima di distribuire il file, convalida la sintassi JSON. Una virgola mancante o un apice non corrispondente possono impedire il caricamento della configurazione. Assicurati che il JSON sia valido: i commenti non sono supportati.
  2. Dopo aver pubblicato il file, ricarica la pagina web. Se il browser mostra ancora il vecchio logo, prova ad aggiornare la pagina forzatamente o ad aprire una finestra di navigazione in incognito e verifica che il browser riesca a caricare correttamente l'URL di ciascuna risorsa.
  3. Esamina sia la schermata di accesso che l'interfaccia dopo aver effettuato l'accesso. Verifica che il nome dell'app, il tema scelto, la destinazione del logo, lo sfondo e i link nel piè di pagina siano corretti e controlla il contrasto del testo nell'elenco delle stanze e nella cronologia.
  4. Controlla gli strumenti per sviluppatori del browser e i log del server web per individuare eventuali richieste di configurazione o di risorse non riuscite. Se utilizzi una CDN o un proxy inverso, cancella o attendi il ripristino delle copie di configurazione e delle risorse memorizzate nella cache, a seconda della tua configurazione.

Per un test del tema in fase di esecuzione, le note di Element relative ai temi descrivono il caricamento di un URL di tema JSON dalla /devtoolssezione "Temi personalizzati". Consideratelo un flusso di lavoro di test o lato utente, non un sostituto per la distribuzione della configurazione desiderata a tutti i client. Per una distribuzione gestibile, mantenete la configurazione e le risorse sotto controllo di versione e ripetete questo controllo durante l'aggiornamento di Element Web.

Il comportamento qui descritto è conforme alla documentazione ufficiale di Element Web relativa alla configurazione e alla personalizzazione dei temi, verificata il 10 ottobre 2026. Prima di fare affidamento su un'impostazione, consultare i riferimenti relativi alla versione installata: documentazione di Element Web sulla configurazione , documentazione di Element Web sulla personalizzazione dei temi e documentazione di installazione di Element Web .

Lascia un commento

Distribuisci Matrix Synapse con Docker Compose e PostgreSQL

Distribuisci Matrix Synapse con Docker Compose e PostgreSQL

Configura un server domestico Synapse persistente con Docker Compose, PostgreSQL, una configurazione privata ed effettua i controlli necessari prima di esporlo tramite HTTPS.

Personalizza il tema e l'immagine coordinata di Element Web

Imposta un nome personalizzato, colori e elementi di accesso per la tua implementazione di Element Web, tenendo presente quali parti rimangono a marchio Element.

Aumenta il limite di file di Systemd in Synapse senza dover fare supposizioni.

Aumenta il limite di file di Systemd in Synapse senza dover fare supposizioni.

Diagnostica se Synapse ha raggiunto il limite di file aperti per processo, imposta un comando systemd specifico per il servizio o il worker corretto e verifica il limite effettivo.

Element mostra "Decrittazione non riuscita"? Ripristina la chiave della stanza mancante

Element mostra "Decrittazione non riuscita"? Ripristina la chiave della stanza mancante

Scopri se l'errore è limitato a un singolo browser o a un singolo evento, quindi utilizza la chiave di ripristino di Element o un dispositivo attendibile senza rischiare di perdere la cronologia crittografata rimanente.

Elimina i vecchi messaggi e file multimediali di Synapse senza perdere dati.

Utilizza le API di Synapse per la cancellazione della cronologia e dei supporti di memorizzazione o le impostazioni di conservazione per rimuovere in modo sicuro i dati obsoleti, quindi verifica il completamento dell'operazione e il recupero dello spazio su disco.

Crea un bot di tipo Matrix Echo in Python con Simple-Matrix-Bot-Lib

Crea un bot di tipo Matrix Echo in Python con Simple-Matrix-Bot-Lib

Installa la libreria corrente, collega un account Matrix dedicato ed esegui un piccolo bot !echo con una gestione più sicura delle credenziali e un test chiaro.

Collega Matrix a WhatsApp, Telegram e Discord con bridge separati.

Collega Matrix a WhatsApp, Telegram e Discord con bridge separati.

Configura tre bridge Mautrix con registrazioni, accessi e test separati, ed evita sorprese legate alla rete Docker, alle policy degli account e alla sincronizzazione.

Recupera spazio su disco in Synapse Media senza compromettere i file condivisi.

Scopri cosa occupa spazio di archiviazione in Synapse, imposta la conservazione sicura dei file multimediali e svuota la cache remota senza eliminare i file direttamente dal disco.

Disattivare gli utenti Matrix inattivi senza eliminare la cronologia delle stanze

Disattivare gli utenti Matrix inattivi senza eliminare la cronologia delle stanze

Esamina l'attività del dispositivo, disattiva gli account Synapse inattivi confermati tramite l'API di amministrazione e scopri cosa rimuove effettivamente il flag di cancellazione opzionale.

Ridurre la pressione sulla memoria di PostgreSQL in Matrix Synapse

Scopri se l'utilizzo della memoria PostgreSQL deriva da query, buffer condivisi, connessioni o operazioni di manutenzione, quindi apporta modifiche mirate e compatibili con Synapse.