Personnalisez le thème et l'image de marque d'Element Web

Pour un déploiement Element Web auto-hébergé, définissez le nom de l'application et le thème par défaut dans son fichier de configuration config.json, puis utilisez les brandingoptions documentées pour le logo de connexion, l'arrière-plan, le lien du logo et les liens du pied de page. Pour des couleurs personnalisées, définissez un thème dans les paramètres setting_defaults.custom_themeset indiquez default_themeson custom-nom. Ces paramètres personnalisent Element, mais ne le transforment pas en un produit entièrement personnalisable.

Sachez de quels contrôles de marque vous avez besoin

La configuration d'Element sépare l'identité du produit, les thèmes de couleurs et les ressources de la page. Choisissez la modification minimale qui répond à votre objectif :

ObjectifConfigurationCe qu'il change
Afficher le nom de votre servicebrandNom de l'application dans différentes chaînes de caractères et à différents endroits
Choisissez un thème de démarrage clair, sombre ou personnalisé.default_themeThème de couleurs par défaut pour le déploiement
Modifier l'identifiant et l'apparence de bienvenuebrandingLogo de la page d'authentification, arrière-plan, lien du logo et liens du pied de page
Définir des couleurs et des polices personnaliséessetting_defaults.custom_themesLes options de thème, telles que les jetons de couleur et les familles de polices, sont des éléments importants.

Vérifié : La documentation d’Element indique que la personnalisation est possible, mais pas le changement complet de marque ni l’utilisation d’une marque privée. Conséquence pratique : les modifications brandne remplaceront pas tous les logos, icônes, images ou références produits. Si vous souhaitez modifier tous les éléments visuels et textuels, prévoyez de maintenir une version personnalisée et de la vérifier après chaque mise à jour. Avant d’opter pour une configuration uniquement, commencez par lister précisément les éléments d’interface utilisateur que vos utilisateurs doivent voir.

Mettez à jour la configuration déployée en toute sécurité

Element Web est lu config.jsonau démarrage. Sauvegardez le fichier actuel et modifiez-le directement afin de conserver les paramètres nécessaires , comme le serveur d'accueil par défaut. Pour une archive tar.gz, le fichier se trouve dans le répertoire web déployé ; le paquet Debian utilise /etc/element-web/config.json`/etc/web.config .../app/config.json

Ajoutez les clés suivantes à l'objet JSON existant, en les combinant avec les paramètres déjà présents. Ne copiez pas ceci en remplacement de la configuration complète :

{
  "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" }
    ]
  }
}

Remplacez le nom, les noms d'hôte et les ressources d'exemple par les vôtres. brandModifiez le nom de l'application à différents endroits ; permalink_prefixles permaliens partagés pointent désormais vers votre déploiement Element plutôt que vers l' matrix.toURL d'origine. Le logo et l'arrière-plan sont des URL chargées par le navigateur. Servez-les via HTTPS depuis un emplacement accessible à vos utilisateurs et assurez-vous que les contrôles d'accès, la politique de sécurité du contenu et la mise en cache ne les bloquent pas. La documentation ne spécifie pas de taille d'image universelle pour le logo d'authentification ; prévisualisez donc votre ressource plutôt que de supposer une dimension fixe.

Cela dépend du déploiement : un fichier de configuration affecte l’instance Element Web qui le héberge. Il ne modifie pas le app.element.ioservice officiel ni les applications mobiles ou de bureau Element. Effectuez la modification sur l’hôte ou le conteneur hébergeant votre instance.

Ajouter un thème de couleur personnalisé

Pour un thème de couleurs et de polices simple, Element documente les définitions de thèmes personnalisés dans `<template>` setting_defaults.custom_themes. Le nom interne du thème est préfixé par `<template> custom-` ; utilisez ce nom complet dans ` default_theme<template>`. Cet exemple présente un thème personnalisé compact. Il s'agit d'un point de départ, et non d'une palette complète.

{
  "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"
        }
      }
    ]
  }
}

Fusionnez ces clés avec votre JSON existant plutôt que de créer un second setting_defaultsobjet. Veillez à ce que le contraste entre le texte, les arrière-plans et les contrôles reste lisible, que l'élément soit en mode normal ou sélectionné. La documentation du thème d'Element inclut des couleurs optionnelles supplémentaires, des palettes de couleurs pour les noms d'utilisateur et les avatars, des polices personnalisées et des jetons de conception Compound. N'ajoutez que les valeurs que vous avez vérifiées dans la documentation actuelle ; une palette incomplète peut entraîner l'utilisation des valeurs par défaut pour certaines parties de l'interface.

Erreur fréquente : ce paramètre default_themedéfinit le thème par défaut du déploiement ; la documentation ne le décrit pas comme une politique qui verrouille les paramètres d’apparence de chaque utilisateur. Si vous avez besoin d’un thème imposé, vérifiez ce comportement avec la version exacte d’Element Web que vous utilisez au lieu de supposer que le thème par défaut est verrouillé.

Appliquez la modification et vérifiez le résultat.

  1. Vérifiez la syntaxe JSON avant le déploiement. Une virgule manquante ou des guillemets mal placés peuvent empêcher le chargement de la configuration. Utilisez un JSON valide : les commentaires ne sont pas pris en charge.
  2. Rechargez la page web après la publication du fichier. Si l'ancien logo s'affiche toujours dans le navigateur, effectuez un rechargement forcé ou ouvrez une fenêtre de navigation privée et vérifiez que le navigateur peut bien récupérer l'URL de chaque ressource.
  3. Vérifiez l'écran de connexion et l'interface une fois connecté(e). Assurez-vous que le nom de l'application, le thème choisi, l'emplacement du logo, l'arrière-plan et les liens du pied de page sont corrects, et contrôlez le contraste du texte dans la liste des salles et la chronologie.
  4. Vérifiez les outils de développement de votre navigateur et les journaux du serveur web pour détecter les échecs de configuration ou de requêtes de ressources. Si vous utilisez un CDN ou un proxy inverse, videz le cache ou attendez sa réinitialisation, conformément à votre configuration.

Pour tester un thème en cours d'exécution, la documentation d'Element indique de charger une URL de thème JSON depuis /devtoolsla section « Thèmes personnalisés ». Il s'agit d'une méthode de test ou d'un processus côté utilisateur, et non d'un substitut au déploiement de la configuration prévue sur tous les clients. Pour un déploiement maintenable, conservez la configuration et les ressources sous contrôle de version et répétez cette vérification lors de la mise à jour d'Element Web.

Le comportement décrit ici suit la documentation officielle de configuration et de thèmes d'Element Web vérifiée le 10 octobre 2026. Consultez les références de votre version installée avant de vous fier à un paramètre : référence de configuration d'Element Web , documentation sur les thèmes d'Element Web et documentation d'installation d'Element Web .

Laisser un commentaire

Déploiement de Matrix Synapse avec Docker Compose et PostgreSQL

Déploiement de Matrix Synapse avec Docker Compose et PostgreSQL

Configurez un serveur Synapse persistant avec Docker Compose, PostgreSQL, une configuration privée et des vérifications avant de l'exposer via HTTPS.

Personnalisez le thème et l'image de marque d'Element Web

Définissez un nom de marque, des couleurs personnalisées et des éléments de connexion pour votre déploiement Element Web tout en identifiant les éléments qui restent de marque Element.

Augmenter la limite de fichiers systemd de Synapse sans tâtonnement

Augmenter la limite de fichiers systemd de Synapse sans tâtonnement

Déterminez si Synapse a atteint sa limite de fichiers ouverts par processus, configurez un module systemd pour le service ou le processus approprié et vérifiez la limite en temps réel.

L'élément affiche « Échec du décryptage » ? Restaurez la clé de la pièce manquante

L'élément affiche « Échec du décryptage » ? Restaurez la clé de la pièce manquante

Déterminez si l'erreur est limitée à un navigateur ou à un événement, puis utilisez la clé de récupération d'Element ou un appareil de confiance sans risquer de perdre votre historique chiffré restant.

Nettoyez vos anciens messages et fichiers multimédias Synapse sans perdre de données.

Utilisez les API d'historique et de purge multimédia de Synapse ou les paramètres de rétention pour supprimer les données obsolètes en toute sécurité, puis vérifiez l'achèvement de l'opération et la récupération de l'espace disque.

Créez un robot Matrix Echo en Python avec Simple-Matrix-Bot-Lib

Créez un robot Matrix Echo en Python avec Simple-Matrix-Bot-Lib

Installez la bibliothèque actuelle, connectez un compte Matrix dédié et exécutez un petit bot !echo avec une gestion des identifiants plus sûre et un test clair.

Connectez Matrix à WhatsApp, Telegram et Discord via des ponts séparés.

Connectez Matrix à WhatsApp, Telegram et Discord via des ponts séparés.

Configurez trois ponts Mautrix avec des enregistrements, des connexions et des tests distincts, et évitez ainsi les surprises liées au réseau Docker, aux politiques de compte et à la synchronisation.

Récupérez de l'espace disque sur Synapse Media sans endommager les fichiers partagés

Découvrez ce qui occupe l'espace de stockage de Synapse, définissez une durée de conservation des médias sécurisée et purgez le cache distant sans supprimer directement les fichiers du disque.

Désactiver les utilisateurs inactifs de Matrix sans supprimer l'historique des salles

Désactiver les utilisateurs inactifs de Matrix sans supprimer l'historique des salles

Consultez l'activité des appareils, désactivez les comptes Synapse inactifs confirmés via l'API d'administration et découvrez ce que supprime réellement l'option d'effacement.

Réduire la pression sur la mémoire de PostgreSQL dans Matrix Synapse

Déterminez si la mémoire utilisée par PostgreSQL provient des requêtes, des tampons partagés, des connexions ou de la maintenance, puis apportez des modifications ciblées compatibles avec Synapse.