Wie kann ich zusätzliche Head-Tags in Contao mit einem Twig-Seitenlayout ausgeben?

Es gibt zwei Wege, um Meta-Tags, Skripte oder CSS-Code im <head> deiner Contao-Website mit Twig-Layout einzubinden:

Weg 1: Mit dem Theme themore (Bequem über das Backend)

Wenn du das Contao-Theme themore nutzt, musst du kein Template anpassen:

  1. Navigiere im Backend zu Layout > Themes.
  2. Klicke bei deinem Theme auf das Icon „Inhaltselemente des Themes bearbeiten“ und wähle Settings.
  3. Trage deinen individuellen Code (z. B. Google Tag Manager, Matomo oder Custom CSS) in das Textfeld „Zusätzliche Head-Tags“ ein und speichere ab.

Weg 2: Ohne Theme-Funktion (Über das Template Studio)

Falls dein Theme diese Option nicht bietet, kannst du das Standard-Template anpassen:

  1. Gehe im Backend zu Entwickler-Tools > Template Studio.
  2. Suche nach page/layout und klicke auf „Ihr Template erstellen“ (erstellt eine layout.html.twig im Ordner templates/page/).
  3. Ergänze deinen Code im entsprechenden Twig-Block:
    {% block head %}
        {{ parent() }}
        <script src="https://example.com/script.js" defer></script>
    {% endblock %}
  4. Wichtig: Leere anschließend den Anwendungscache (über den Contao Manager oder den Debug-Modus), damit die Twig-Änderungen wirksam werden.