Zum Hauptinhalt springen
Diese Seite ist ein umfassender Referenzleitfaden der Syntax und der verfügbaren Parameter für alle standardmäßigen HubL-Tags, einschließlich der Tags für Systemseiten wie die E-Mail-Abonnement-Seite. Jedes der folgenden Tags enthält ein Beispiel für die grundlegende Syntax sowie ein Beispiel mit Parametern und Code-Ausgabe. Wenn Sie Drag-&-Drop-Bereiche erstellen, erfahren Sie hier mehr über Drag- & -Drop-Bereich-Tags. Wenn Sie eine ältere Website betreiben, sollten Sie sich auch die Liste der veralteten HubL-Tags ansehen.
Für die meisten Tags auf dieser Seite gibt es Äquivalente in den Standardmodulen. Module können innerhalb von dnd_areas und flexiblen Spalten verwendet werden, was sie leistungsfähiger und benutzerfreundlicher macht als die Tags, die Sie hier sehen.

Blogkommentare

Rendert den Code zum Einbetten von Kommentaren in einer Blog-Vorlage, einschließlich der Kommentare selbst und des Formulars für Kommentare. Weitere Informationen zum Anpassen der Einstellungen für Blogkommentare und Formulare finden Sie in der Wissensdatenbank.

Blog-Inhalt

Während Drag-and-Drop-Layouts ein Blog-Inhaltsmodul enthalten, werden diese Module nicht mit einem einzigen Tag erstellt. Sie verwenden stattdessen bedingte Logik, um zu definieren, wie ein Blogbeitrag und eine Blog-Auflistung gerendert werden sollen. Mehr über die Programmieren von Blog-Vorlagen erfahren Sie hier.

Blogbeitragsfilter

Erstellt eine verlinkte Auflistung von Beiträgen nach Thema, Beiträgen nach Monat oder Beiträgen nach Autor.

Hinweis:

Dieses Modul kann nur in Blogbeitragsvorlagen verwendet werden.

Blogbeitragsauflistung

Fügt eine Auflistung der beliebtesten oder besten Beiträge hinzu.

Hinweis:

Dieses Tag kann nur in Blogbeitragsvorlagen verwendet werden. Der Inhalt des Tags wird asynchron auf der Client-Seite geladen. Wenn Sie also den Feed nach dem Laden bearbeiten möchten, müssen Sie eine globale JS-Funktion definieren, die diese Bearbeitung übernimmt. Verwenden Sie die Funktion hsPostListingComplete(feeds), wobei feeds der jQuery-Selektor in allen Feeds ist, die abgeschlossen wurden. Sie sollten das DOM-Objekt in dieser Funktion direkt bearbeiten.

Beiträge im Zusammenhang mit dem Blog

Fügt eine Auflistung von Blogbeiträgen hinzu, die auf einer Reihe von Parametern basiert, die von Beiträgen verschiedener Blogs geteilt werden. Beiträge werden anhand ihrer Relevanz für die festgelegten Parameter ausgewählt. Dieses Tag generiert nicht ein bearbeitbares Modul auf Seiten-/Beitragsebene, sondern wird vollständig mit HubL konfiguriert.
Wir empfehlen dringend die Verwendung des callback-Parameters anstelle von post_formatter, um die Ladegeschwindigkeit der Seite zu verbessern.

Beispiele

In diesem Beispiel wird eine Auflistung von Beiträgen generiert, die von einem der drei angegebenen blog_authors in zwei verschiedenen Blogs verfasst wurden.
Im folgenden Beispiel wird eine Liste mit 10 Beiträgen generiert, die sich auf einen bestimmten Blogbeitrag beziehen, das Blog-Tag „sales enablement“ enthalten und auf einen bestimmten Veröffentlichungszeitraum beschränkt sind. Dieses Beispiel gibt den blog_post_ids-Parameter an, sodass er auf einer Seite verwendet wird.
Im folgenden Beispiel wird mithilfe des callback-Parameters eine Auflistung von fünf Beiträgen generiert, um die HTML-Ausgabe der Beitrags-Auflistung zu steuern.

Social-Media-Sharing in Blogs

Bei Social-Media-Sharing in Blogs werden Teilen-Zähler in Ihren Blogbeiträgen dargestellt (falls in den Inhaltseinstellungen aktiviert).

Blog-Abonnement

Ein Blog-Abonnement-Tag rendert das Blog-Abonnement-Formular für einen bestimmten Blog. Dieses Formular wird automatisch erstellt, wenn ein Blog in den Inhaltseinstellungen erstellt wird, und es gibt immer ein einziges Anmeldeformular pro Blog. Bitte beachten Sie, dass die Felder des Anmeldeformulars auf der Benutzeroberfläche des Formular-Editors konfiguriert werden.

Boolesch

Ein boolesches Tag erstellt ein Kontrollkästchen auf der Benutzeroberfläche, das „true“ oder „false“ ausgibt. Zusätzlich zur Ausgabe des Wertes ist dieses Modul nützlich für die Definition einer bedingten Vorlagenlogik, wenn es mit dem Parameter export_to_template_context kombiniert wird.

Auswahl

Ein choice-Tag erstellt ein Dropdown-Feld auf der Benutzeroberfläche des Content-Editors, das den vom Benutzer ausgewählten Wert ausgibt. choice-Tags eignen sich hervorragend, um Ihren BenNutzern eine Reihe von voreingestellten Optionen zu bieten, z. B. den Seitentyp als Header zu drucken. Zusätzlich zur Ausgabe des Auswahlwerts ist dieses Tag nützlich für die Definition einer bedingten Vorlagenlogik, wenn es mit dem Parameter export_to_template_context kombiniert wird.

Farbe

Das color-Tag erzeugt eine Farbauswahl auf der Benutzeroberfläche des Seiten-Editors, die einen HEX-Farbwert in einer Vorlage ausgibt. Bitte beachten Sie, dass dieses Modul nur in Vorlagen und nicht in CSS-Dateien verwendet werden kann. Wenn Sie dieses Tag in einem <style> oder Inline-CSS verwenden, sollten Sie den no_wrapper=True-Parameter verwenden, um den <span>-Wrapper zu entfernen.

CTA

Ein Call-to-Action- oder CTA-Tag ermöglicht es Benutzern, eine HubSpot-Call-to-Action-Schaltfläche zu einem vordefinierten Bereich einer Seite hinzuzufügen.
*Diese Parameter sind hier zwar der Vollständigkeit halber aufgeführt, aber der von HubSpot generierte Code, mit dem sie ausgefüllt werden, ist sehr spezifisch. Wenn ein Standard-CTA ausgewählt werden muss, sollten Sie nicht versuchen, die CTA-Parameter von Grund auf neu zu entwickeln, sondern den CTA in einem Vorlagenlayout einrichten und dann in eine Datei klonen. Sie können dann das HubL-CTA-Modul des CTA mit allen korrekt festgelegten Parametern für Sie kopieren.Es gibt auch eine CTA-Funktion, die einen CTA von der ID generiert.

Benutzerdefinierter HTML-Code

Ein benutzerdefiniertes HTML-Modul ermöglicht die Eingabe von unformatiertem HTML in den Content-Editor. Wenn Sie dem Tag umfangreichen Standard-HTML hinzufügen müssen, sollten Sie Block-Syntax verwenden.

Benutzerdefinierte Module

Mithilfe von benutzerdefinierten Modulen können HubSpot-Designer eine benutzerdefinierte Gruppe von bearbeitbaren Inhaltsobjekten erstellen, die in Vorlagen und Seiten im CMS von HubSpot verwendet werden können, während Marketingexperten den spezifischen Inhalt, der in diesen Modulen angezeigt wird, seitenweise steuern können. Weitere Informationen zu benutzerdefinierten Module und ihre vereinfachten HubL-Syntax finden Sie hier. Benutzerdefinierte Module müssen im Editor für benutzerdefinierte Module erstellt werden, sie können jedoch in Code-Vorlagen und HubL-Module einbezogen werden. In der rechten Seitenleiste des Editors für benutzerdefinierte Module wird unter „Vorlagennutzung“ ein „Nutzungs-Snippet“ angezeigt. Benutzerdefinierte Module benötigen die ID des Moduls als Zeichenfolge sowie einen path-Parameter, um anzugeben, welches Modul geladen werden soll. Das Nutzungs-Snippet enthält auch einen label-Parameter. Siehe die nachstehende Syntax:

Editor-Platzhalter

Um Platzhalterinhalte für ein Modul im Editor darzustellen, können Sie entweder Standardinhalte zu Modulfeldern hinzufügen oder das editor_placeholder-HubL-Tag verwenden. Dies kann nützlich sein, wenn das Modul keinen Standard-Content hat oder benötigt, oder um die Modulerstellung zu optimieren.
module-placeholder-content
Um einen Editor-Platzhalter zu einem benutzerdefinierten Modul hinzuzufügen, fügen Sie zunächst eine if-Anweisung zum HTML-Code des Moduls hinzu, um den Platzhalter zu rendern, wenn im Editor kein Inhalt ausgewählt ist. Zum Beispiel könnte der folgende Code verwendet werden, um einen Editor-Platzhalter zu einem CTA-Modul hinzuzufügen:
Die erste if-Anweisung gibt an, ob das Modul vorhanden ist. Dann identifiziert die elif-Anweisung, ob das Modul im Kontext des Editors mithilfe der is_in_editor-Variablen gerendert wird.Diese Variable gibt true zurück, wenn der Inhalt in einem beliebigen Content-Editor gerendert wird, aber Sie können mit anderen In-App-Editor- und Vorschau-Variablen noch spezifischer sein.
Definieren Sie dann den Platzhalterinhalt in der meta.json-Datei des Moduls.

Flexible Spalte

Flexible Spalten sind vertikale Spalten in einer Vorlage, mit denen Content-Autoren mithilfe des Content-Editors Module in die Seite einfügen und entfernen können. Wenn Sie eine flexible Spalte mit HubL programmieren, können Sie andere HubL-Module so einbinden, dass sie standardmäßig in der flexiblen Spalte erscheinen. Das nachstehende Code-Beispiel zeigt die grundlegende Syntax und ein Beispiel für eine flexible Spalte mit einem Rich-Text- und Formularmodul als Standard-Content. Bitte beachten Sie, dass flexible Spalten nur zu Seitenvorlagen hinzugefügt werden können, nicht zu Blog- oder E-Mail-Vorlagen. Module können keine flexiblen Spalten enthalten, aber sie können stattdessen wiederholbare Felder und Gruppen enthalten, die eine ähnliche Funktionalität bieten.

Hinweis:

Wenn Sie dieses Tag verwenden, muss daslabel dem name-Wert folgen, damit die flexible Spalte im Content-Editor funktioniert. Die folgende Syntax ist beispielsweise ungültig:[% widget_container label="My label" "my_flexible_column" %}

Formular

Ermöglicht Benutzern die Auswahl eines HubSpot-Formulars, das sie ihrer Seite hinzufügen können. Der folgende Code enthält ein Beispiel für die Verwendung der Standard-Tag-Syntax von HubL und ein Beispiel für die Verwendung der Blocksyntax.

Fußzeile

Rendert Copyright-Informationen mit dem Jahr und dem Unternehmensnamen, die in den Marketing-E-Mail-Einstellungen des Accounts angegeben sind.

Galerie

Erzeugt ein HubSpot-Galerie-Tag. Dieses Galerie-Tag basiert auf Slick. Sie können zwar ein Galeriemodul mit der HubL-Standardsyntax erstellen, müssen jedoch die Block-Syntax verwenden, wenn Sie Standardfolien mit HubL vordefinieren möchten. Beide Methoden sind unten dargestellt. Galeriebilder werden mithilfe von JavaScript verzögert geladen.
Erzeugt ein Header-Modul, das Text als h1-h6-Tag darstellt.

Symbol

Fügt ein icon-Tag hinzu, mit dem die Benutzer ein Symbol zur Verwendung auswählen können. Unterstützte Symbolsätze sind FontAwesome 5.0.10, 5.14.0 und 6.4.2. Dieses Tag kann nicht in Modulen verwendet werden, die für E-Mail aktiviert sind.

Bild

Erstellt ein Bild-Tag (img), mit dem Benutzer ein Bild aus dem Content-Editor auswählen können. Wenn Sie möchten, dass das Bild mit einer Ziel-URL verknüpft wird, sollten Sie linked_image unten verwenden.

Bildquelle

Ein Bild-SRC-Modul erstellt eine Bildauswahl im Content-Editor, aber anstatt ein img-Tag auszugeben, wird die URL des Bildes dargestellt. Dieses Tag wird in der Regel mit dem no_wrapper=True-Parameter verwendet, sodass das Bild src zu Inline-CSS oder anderem Markup hinzugefügt werden kann. Eine Alternative zur Verwendung dieses Tags ist die Verwendung des export_to_template_context-Parameters.

Sprachumschaltung

Fügt ein Globus-Symbol mit Links zu den übersetzten Versionen einer bestimmten CMS-Seite hinzu. Erfahren Sie in diesem Artikel mehr über mehrsprachige Inhalte.

Verlinktes Bild

Erstellt ein vom Benutzer auswählbares Bild, das in einen Link eingeschlossen ist. Dieses Tag verfügt über alle Parameter eines Bildmoduls mit zwei zusätzlichen Parametern, die die Ziel-URL des Links angeben und ob der Link in einem neuen Fenster geöffnet wird.
Ein logo-Tag rendert das Logo Ihres Unternehmens aus den Brand-Kit-Einstellungen des Accounts.

Menü

Erzeugt ein erweitertes Menü basierend auf einer Menüstruktur unter Inhaltseinstellungen > Erweiterte Menüs. Unter Menüs und Navigation finden Sie weitere Informationen zur Verwendung von Menüs in Vorlagen und Modulen. Wenn id auf null festgelegt ist, stellt das menu-Tag das Standardmenü für den HubSpot-Account dar.

Require_css

Ein HubL-Tag, das ein style-Element in die Warteschlange stellt, das im <head> gerendert werden soll. Dieses Tag ähnelt der require_css-Funktion, mit der Ausnahme, dass Stile mit diesem Tag inline und nicht aus einem Stylesheet eingefügt werden. Dieses Tag wird auch nicht gegen andere Instanzen des CSS auf derselben Seite dedupliziert. Wenn Sie ein Modul erstellen und ein Stylesheet einfügen möchten, dieses Modul jedoch mehrmals auf einer einzelnen Seite verwenden möchten, sollten Sie stattdessen die require_css verwenden.

Require_head

Ein HubL-Tag, das alles, was in standard_header_includes (der <head> der Vorlage) platziert ist, in die Warteschlange stellt. Für die meisten JavaScript und CSS siehe require_js und require_css. Einige Anwendungsfälle für require_head sind die Bereitstellung von Meta-Tags und speziellen Link-Tags (wie prefetch und preconnect) von Modulen.

Require_js

Ein HubL-Tag, das ein zu renderndes Skriptelement in die Warteschlange stellt. Um ein Skript von einer anderen Datei in die Warteschlange zu stellen, um es im <head /> über ein <script />-Element darzustellen (im Gegensatz zu inline wie hier gezeigt), verwenden Sie stattdessen die HubL-Funktion require_js(absolute_url).

Rich-Text

Erzeugt einen WYSIWYG-Content-Editor.

RSS-Listing

Lädt eine Liste von Inhalten aus einem internen oder externen RSS-Feed.

Hinweis:

Dieses Modul wird asynchron auf der Client-Seite geladen. Wenn Sie also den Feed nach dem Laden bearbeiten möchten, müssen Sie eine globale JS-Funktion definieren, die diese Bearbeitung übernimmt. Verwenden Sie die Funktion hsRssFeedComplete(feeds), wobei feeds der jQuery-Selektor in allen Feeds ist, die abgeschlossen wurden. Sie können das DOM-Objekt in dieser Funktion direkt bearbeiten.

Bereichsüberschrift

Erzeugt eine HTML-Überschrift und eine <p>-Zwischenüberschrift.

Einfaches Menü

Mit einfachen Menüs können Sie grundlegende Navigationsmenüs erstellen, die auf Seitenebene geändert werden können. Im Gegensatz zu normalen Menümodulen werden einfache Menüs nicht über den Navigationsbildschirm in den Website-Einstellungen verwaltet, sondern über die Vorlagen- und Seiten-Editoren. Sie können Block-Syntax verwenden, um einer Standard-Menüstruktur einzurichten.

Social-Media-Sharing

Social-Media-Sharing-Tags generieren Social-Media-Symbole, die zum Teilen einer bestimmten Seite verwendet werden können. Dieses Modul kann mit der Block-Syntax verwendet werden, um die Symbolbilder und mehr anzupassen.

Abstandshalter

Ein spacer-Tag erzeugt ein leeres span-Tag. Dieses Tag kann als Abstandshalter formatiert werden. In Drag-and-Drop-Layouts wird das Abstandshaltermodul in einen Container mit der Klasse „span1-span12“ eingeschlossen, um festzulegen, wie viel Platz das Modul im zwölfspaltigen responsiven Raster einnehmen soll.

Systemseiten-Tags

Die folgenden Tags können auf Systemseiten verwendet werden, z. B. auf den Seiten zum Zurücksetzen des Passworts oder zum Abonnieren von E-Mails.

E-Mail-Back-up Abo-Kündigung

Das Abo-Kündigungs-Back-up-Tag wird für E-Mail-Empfänger gerendert, falls HubSpot deren E-Mail-Adresse nicht ermitteln kann, wenn dieser Empfänger versucht, ein Abo zu kündigen. Mit diesem Tag wird ein Formular adargestellt, in das der Kontakt seine E-Mail-Adresse eingeben kann, um sich von der E-Mail-Kommunikation abzumelden. Es sollte auf einer Abmelde-Backup-Systemvorlage verwendet werden.

E-Mail-Abonnements

Dieses Modul rendert, wenn ein E-Mail-Empfänger seine Abonnementeinstellungen bearbeiten möchte. Es sollte auf einer Abo-Einstellungen-Systemvorlage verwendet werden.

E-Mail-Abo-Bestätigung

Die Aktualisierungsbestätigung für E-Mail-Abonnements ist ein Modul, das der Danksagungsvorlage hinzugefügt werden kann, wenn ein Empfänger seine Abonnementeinstellungen aktualisiert oder sich abmeldet. Es sollte auf einer Abo-Einstellungen-Systemvorlage verwendet werden.

Anmeldung für zugriffsbeschränkte Inhalte

Erstellt ein Anmeldeformular für den Zugang zu privatem Content.

Registrierung einer Zugriffsberechtigung

Erstellt ein Formular zur Registrierung für den Zugang zu privatem Content.

Anfrage zum Zurücksetzen des Passworts

Erstellt ein Formular zum Versenden einer E-Mail zum Zurücksetzen des Passworts für den Zugriff auf passwortgeschützte Seiten.

Zurücksetzen des Passworts

Rendert ein Formular zum Zurücksetzen des Passworts für den Zugriff auf passwortgeschützte Seiten.

Passwortaufforderung

Fügt eine Passwortaufforderung zu passwortgeschützten Seiten hinzu.

Text

Erzeugt eine einzelne Textzeile. Dieses Tag kann in Verbindung mit dem no_wrapper=True-Parameter nützlich sein, um Ihrem Markup hinzugefügt zu werden. Wenn Sie zum Beispiel möchten, dass Ihre Endbenutzer das Ziel eines vordefinierten Anchors definieren können, könnten Sie die href mit einem Texmodul mit no_wrapper=True ausfüllen.

Textbereich (Textarea)

Ein Textbereich (textarea) ähnelt einem Textmodul insofern, dass Benutzern die Eingabe von Klartext ermöglicht wird, ihnen aber einen größeren Bereich für das Arbeiten im Content-Editor bietet. Dieses Modul unterstützt kein HTML. Wenn Sie „textarea“ direkt innerhalb eines vordefinierten Wrapping-Tags verwenden möchten, fügen Sie den no_wrapper=true-Parameter hinzu.

Video-Player

Rendern Sie einen Video-Player für eine Videodatei vom Datei-Manager, für die die Einstellung Einbetten, Teilen und Tracking zulassen aktiviert ist.
Zuletzt geändert am 10. Februar 2026