Bei einer selbstgehosteten Element Web-Bereitstellung legen Sie den App-Namen und das Standarddesign in der Konfigurationsdatei fest config.jsonund verwenden anschließend die dokumentierten brandingOptionen für das Anmeldelogo, den Hintergrund, den Logo-Link und die Fußzeilen-Links. Für benutzerdefinierte Farben definieren Sie ein Design unter der Konfigurationsdatei setting_defaults.custom_themesund verweisen default_themeauf dessen custom-Namen. Diese Einstellungen personalisieren Element, machen es aber nicht zu einem vollständig individualisierbaren Produkt.
Wissen Sie, welche Branding-Kontrollen Sie benötigen?
Die Element-Konfiguration trennt Produktidentität, Farbthemen und Seitenressourcen. Wählen Sie die kleinste Änderung, die Ihr Ziel erreicht:
| Ziel | Konfiguration | Was es ändert |
| Zeigen Sie Ihren Dienstnamen an | brand | App-Name in verschiedenen Zeichenketten und an verschiedenen Stellen |
| Legen Sie ein helles, dunkles oder benutzerdefiniertes Startdesign fest. | default_theme | Standardfarbschema für die Bereitstellung |
| Änderung des Anmelde- und Willkommensdesigns | branding | Logo, Hintergrund, Logo-Link und Fußzeilenlinks der Authentifizierungsseite |
| Benutzerdefinierte Farben und Schriftarten festlegen | setting_defaults.custom_themes | Designoptionen wie Farbsymbole und Schriftfamilien |
Bestätigt: Die Dokumentation von Element gibt an, dass es einige Anpassungen unterstützt, jedoch kein vollständiges Rebranding oder Private Labeling. Praktische Konsequenz: Änderungen brandersetzen nicht jedes Logo, Symbol, Bild oder jeden Produktverweis. Wenn Sie alle visuellen Elemente und Texte ändern müssen, sollten Sie eine angepasste Version pflegen und diese nach Aktualisierungen erneut überprüfen. Erstellen Sie zunächst eine Liste der UI-Elemente, die Ihre Benutzer sehen sollen, bevor Sie sich für einen reinen Konfigurationsansatz entscheiden.
Aktualisieren Sie die bereitgestellte Konfiguration sicher
Element Web liest die Konfigurationsdatei config.jsonbeim Start ein. Sichern Sie die aktuelle Datei und bearbeiten Sie sie direkt, um wichtige Einstellungen wie den Standard-Homeserver beizubehalten. Bei einem Release-Tarball befindet sich die Datei im bereitgestellten Webverzeichnis; das Debian-Paket verwendet /etc/element-web/config.json. Bei Docker binden Sie Ihre Konfiguration unter ein /app/config.json. Der korrekte Speicherort hängt von Ihrer Element-Installation ab. Überprüfen Sie daher Ihre Bereitstellungsmethode, bevor Sie die Datei bearbeiten.
Fügen Sie die folgenden Schlüssel zum bestehenden JSON-Objekt hinzu und kombinieren Sie sie mit bereits vorhandenen Einstellungen. Fügen Sie dies nicht als Ersatz für die gesamte Konfiguration ein:
{
"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" }
]
}
}
Ersetzen Sie den Beispielnamen, die Hostnamen und die Assets durch Ihre eigenen. brandDer App-Name wird an verschiedenen Stellen geändert; permalink_prefixfreigegebene Permalinks verweisen dann auf Ihre Element-Bereitstellung anstatt auf matrix.to. Die Logo- und Hintergrund-Einträge sind URLs, die vom Browser geladen werden. Stellen Sie sicher, dass diese über HTTPS von einem für Ihre Benutzer erreichbaren Ort bereitgestellt werden und dass Zugriffskontrollen, Content Security Policy und Caching sie nicht blockieren. Die Dokumentation gibt keine einheitliche Bildgröße für das Authentifizierungslogo an. Überprüfen Sie daher Ihre tatsächliche Asset-Datei in der Vorschau, anstatt von einer festen Größe auszugehen.
Abhängig von der Bereitstellung: Eine Konfigurationsdatei wirkt sich auf die Element-Webinstanz aus, die sie bereitstellt. Sie ändert weder den offiziellen app.element.ioDienst noch automatisch die separaten mobilen oder Desktop-Apps von Element. Nehmen Sie die Änderung auf dem Host oder im Container vor, der Ihre eigene Instanz bereitstellt.
Fügen Sie ein benutzerdefiniertes Farbschema hinzu
Für ein einfaches Farb- und Schriftartenthema dokumentiert Element benutzerdefinierte Themendefinitionen in der Datei `<theme.php` setting_defaults.custom_themes. Der interne Name des Themas beginnt mit `<theme.php` custom-; verwenden Sie diesen vollständigen Namen in der default_themeDatei `<theme.php`. Dieses Beispiel zeigt ein kompaktes benutzerdefiniertes Thema. Es ist ein Ausgangspunkt, keine vollständige Farbpalette.
{
"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"
}
}
]
}
}
Fügen Sie diese Schlüssel in Ihr bestehendes JSON ein, anstatt ein zweites setting_defaultsObjekt zu erstellen. Achten Sie darauf, dass der Kontrast zwischen Text, Hintergrund und Steuerelementen sowohl im normalen als auch im hervorgehobenen Zustand gut lesbar ist. Die Designreferenz von Element enthält zusätzliche optionale Farben, Farbarrays für Benutzername und Avatar, benutzerdefinierte Schriftarten und Compound-Design-Tokens. Fügen Sie nur Werte hinzu, die Sie in der aktuellen Referenz geprüft haben; eine unvollständige Farbpalette kann dazu führen, dass Teile der Benutzeroberfläche Standardwerte verwenden.
Häufiges Missverständnis: Die Einstellung default_themewählt das Standarddesign der Bereitstellung aus; die Dokumentation beschreibt sie nicht als Richtlinie, die die Darstellungseinstellungen aller Benutzer festlegt. Wenn Sie ein strikt erzwungenes Design benötigen, überprüfen Sie dieses Verhalten anhand der exakten Element Web-Version, die Sie verwenden, anstatt anzunehmen, dass die Standardeinstellung eine Sperre darstellt.
Die Änderung anwenden und das Ergebnis überprüfen
- Prüfen Sie die JSON-Syntax vor der Bereitstellung. Fehlende Kommas oder falsch gesetzte Anführungszeichen können das Laden der Konfiguration verhindern. Achten Sie auf gültiges JSON: Kommentare werden nicht unterstützt.
- Laden Sie die Webseite nach der Veröffentlichung der Datei neu. Falls der Browser weiterhin das alte Branding anzeigt, testen Sie einen vollständigen Seitenneuladen oder ein privates Fenster und prüfen Sie, ob der Browser die URLs der einzelnen Assets erfolgreich abrufen kann.
- Überprüfen Sie sowohl den Anmeldebildschirm als auch die Benutzeroberfläche nach der Anmeldung. Stellen Sie sicher, dass App-Name, gewähltes Design, Logo-Ziel, Hintergrund und Fußzeilenlinks korrekt sind, und prüfen Sie den Textkontrast in der Raumliste und der Zeitleiste.
- Überprüfen Sie die Entwicklertools Ihres Browsers und die Webserver-Protokolle auf fehlgeschlagene Konfigurations- oder Ressourcenanforderungen. Wenn Sie ein CDN oder einen Reverse-Proxy verwenden, löschen Sie dessen zwischengespeicherte Konfigurations- und Ressourcenkopien oder warten Sie, bis diese geladen sind, je nach Ihrer Konfiguration.
Für einen Laufzeit-Theme-Test beschreiben die Theme-Hinweise von Element das Laden einer JSON-Theme-URL /devtoolsunter „Benutzerdefinierte Themes“. Betrachten Sie dies als Test- oder benutzerseitigen Workflow und nicht als Ersatz für die Bereitstellung der gewünschten Konfiguration auf allen Clients. Für eine wartungsfreundliche Bereitstellung sollten Sie die Konfiguration und die Assets unter Versionskontrolle halten und diese Prüfung bei jedem Upgrade von Element Web wiederholen.
Das hier beschriebene Verhalten entspricht der offiziellen Element Web-Konfigurations- und Designdokumentation (Stand: 10. Oktober 2026). Bevor Sie sich auf eine Einstellung verlassen, sollten Sie die Referenzen für Ihre installierte Version überprüfen: Element Web-Konfigurationsreferenz , Element Web-Designdokumentation und Element Web-Installationsdokumentation .