Shortcode

Shortcode bedeutet sinngemäß Kurzcode. Das Konzept ermöglicht Redakteuren, komplexe Funktionen in Inhalte einzufügen, ohne den vollständigen HTML-, PHP- oder JavaScript-Code bearbeiten zu müssen. Besonders verbreitet sind Shortcodes in WordPress, wo Themes, Plugins oder individuelle Funktionen solche Platzhalter bereitstellen.

Wie funktioniert ein Shortcode?

Ein Shortcode besteht aus einem eindeutigen Namen und optionalen Attributen. Ein einfaches Beispiel lautet . Sobald WordPress den Seiteninhalt verarbeitet, sucht das System nach registrierten Shortcodes, führt die verknüpfte Funktion aus und setzt deren Ergebnis an der entsprechenden Stelle ein.

Attribute steuern die Ausgabe genauer. Der Code kann beispielsweise festlegen, welche Medien eine Galerie enthält. Je nach Erweiterung lassen sich auch Layout, Anzahl, Reihenfolge oder andere Eigenschaften über solche Parameter bestimmen.

• Selbstschließende Shortcodes bestehen nur aus einem Platzhalter, etwa [kontaktformular].
• Umschließende Shortcodes verarbeiten zusätzlichen Inhalt, etwa [hinweis]Text[/hinweis].
• Shortcodes mit Attributen erhalten Parameter, die ihre Darstellung oder Funktion anpassen.

Shortcodes in WordPress einfügen

In WordPress kannst du einen Shortcode in einen dafür vorgesehenen Shortcode-Block eintragen. In älteren Editoren oder bestimmten Seitenerstellungsprogrammen funktioniert häufig auch ein Textfeld. Welche Variante geeignet ist, hängt vom verwendeten Theme, Plugin und Editor ab.

Vor dem Einfügen solltest du in der Dokumentation des Plugins prüfen, welchen Namen und welche Attribute der Platzhalter erwartet. Schon ein abweichendes Zeichen, ein nicht geschlossenes Attribut oder eine falsche Schreibweise kann verhindern, dass WordPress die gewünschte Ausgabe erzeugt.

Eigenen Shortcode erstellen

Ein eigener WordPress-Shortcode wird über eine PHP-Funktion registriert. Diese Funktion nimmt bei Bedarf Attribute und eingeschlossenen Inhalt entgegen und gibt das erzeugte HTML zurück. Die Registrierung erfolgt üblicherweise in einem eigenen Plugin oder in einer dafür vorgesehenen Codebasis des Themes.

Eigene Funktionen gehören nach Möglichkeit in ein Plugin oder Child-Theme. Direkte Änderungen am Haupt-Theme können bei einem Update überschrieben werden. Eine sauber getrennte Umsetzung erleichtert außerdem Wartung, Tests und einen späteren Theme-Wechsel.

Shortcode, Block und HTML im Vergleich

Der Unterschied zwischen einem Shortcode und einem HTML-Code liegt in der Verarbeitung. HTML beschreibt die konkrete Struktur des Inhalts. Ein Shortcode ruft dagegen eine hinterlegte Funktion auf, die den endgültigen HTML-Code erst erzeugt.

Der Unterschied zwischen einem Shortcode und einem WordPress-Block liegt vor allem in der Bearbeitung. Ein Block besitzt normalerweise eine visuelle Oberfläche mit direkt sichtbaren Einstellungen. Ein Shortcode bleibt im Editor ein kompakter Textplatzhalter und zeigt sein Ergebnis häufig erst in der Vorschau oder auf der veröffentlichten Seite.

Relevanz für SEO und GEO

Ein korrekt verarbeiteter Shortcode ist für Suchmaschinen in der Regel kein eigenständiges SEO-Signal. Google bewertet die erzeugte Seite mit ihren sichtbaren Inhalten, Links und HTML-Elementen. Enthält die Ausgabe relevante Texte, strukturierte Überschriften oder interne Links, können diese Bestandteile zur organischen Auffindbarkeit beitragen.

Für GEO, also Generative Engine Optimization, zählt ebenfalls das ausgegebene Ergebnis. Klar strukturierte Definitionen, nachvollziehbare Aussagen und semantisch sauberes HTML erleichtern es Suchmaschinen und KI-Systemen, Inhalte zu erfassen. Der Platzhalter selbst verbessert die KI-Sichtbarkeit nicht.

Auf SEA-Landingpages kann ein Shortcode Formulare, Produktdaten oder Vertrauenselemente bereitstellen. Seine technische Umsetzung beeinflusst dabei Ladezeit, Bedienbarkeit und Conversion. Umfangreiche Datenbankabfragen oder unnötig geladene Skripte können die Seite verlangsamen. Hinweise zur Prüfung solcher Faktoren findest du im Ratgeber zur technischen SEO und im kostenlosen SEO-Check.

Typische Fehler bei Shortcodes

Ein nicht registrierter Shortcode erscheint häufig unverarbeitet als Text in eckigen Klammern. Das passiert beispielsweise nach der Deaktivierung eines Plugins oder nach einem Theme-Wechsel. Bei einem Relaunch sollten deshalb alle verwendeten Platzhalter inventarisiert und auf der neuen Website getestet werden.

• Das zuständige Plugin ist deaktiviert oder wurde entfernt.
• Der Name oder ein Attribut enthält einen Schreibfehler.
• Öffnender und schließender Platzhalter passen nicht zusammen.
• Die erzeugte Ausgabe enthält ungültiges oder unzugängliches HTML.
• Die Funktion lädt unnötig viele Skripte, Abfragen oder externe Ressourcen.

Shortcodes sauber verwalten

Eine zentrale Dokumentation sollte festhalten, welcher Platzhalter zu welchem Plugin oder Theme gehört, welche Attribute erlaubt sind und auf welchen Seiten er vorkommt. Diese Übersicht reduziert den Prüfaufwand bei Updates, Relaunches und Systemwechseln.

In unserer Projektpraxis fallen veraltete Platzhalter häufig erst nach einem Relaunch auf, weil Formulare, Tabellen oder Infoboxen plötzlich fehlen. Ein Crawling der alten und neuen Website sowie ein visueller Vergleich wichtiger Seitentypen machen solche Abweichungen früh sichtbar. Eine auf Suchmaschinen ausgerichtete WordPress-Website-Entwicklung berücksichtigt diese Abhängigkeiten bereits bei der technischen Planung.

Wenn du eine bestehende Website mit vielen individuellen Shortcodes prüfen oder neu strukturieren möchtest, kann ein technischer Potenzialcheck die betroffenen Seitentypen und Abhängigkeiten sichtbar machen.

Kostenloser Potenzialcheck

Häufige Fragen zu Shortcodes