WordPress wählt eine Template-Datei, indem es eine Liste der Reihe nach durchgeht und die erste nimmt, die existiert. Für einen einzelnen Beitrag lautet die Liste single-{post_type}-{slug}.php, dann single-{post_type}.php, dann single.php, dann singular.php, dann index.php. Nichts wird geroutet und nichts angemeldet, der Dateiname ist das Routing.
index.php ist deshalb die einzige Datei, die ein Theme wirklich braucht, zusammen mit style.css für den Kopfkommentar, der es benennt. Jede weitere Datei ist eine Überschreibung, die die Liste früher abfängt, und eine neue Datei anzulegen ist der Weg, einen einzigen Inhaltstyp anders aussehen zu lassen, ohne etwas Bestehendes anzufassen.
Die Listen, die man auswendig kennt
- Eine Seite:
{custom}.phpaus der eigenen Vorlagenwahl der Seite, dannpage-{slug}.php,page-{id}.php,page.php,singular.php,index.php - Ein Archiv:
archive-{post_type}.php, dannarchive.php, dannindex.php - Eine fehlende Seite:
404.php, dannindex.php singular.phpist die gemeinsame Ausweichdatei für einen Beitrag und eine Seite, und die meisten Themes haben sie nicht und sollten sie haben
Die Slug- und ID-Varianten oben sind der Notausgang, und sie sparsam einzusetzen lohnt sich: Eine Vorlage, benannt nach dem Slug einer einzelnen Seite, ist unsichtbar, bis jemand die Seite umbenennt, und dann fällt das Design still auf die nächste Stufe zurück.
Zwei weitere Tatsachen runden das Bild ab. Eine Template-Datei wird eingebunden, nicht aufgerufen, also steht alles zur Verfügung, was an dieser Stelle im Gültigkeitsbereich liegt: $post, die Abfrage, und was ein Plugin bei einem früheren Hook vorbereitet hat. Und die Schleife ist ausdrücklich vorhanden statt implizit, weshalb eine Vorlage, die the_post() vergisst, denselben Beitrag mehrfach oder gar nichts ausgibt.
Zwei Arten von Themes, und der Blick, der sie unterscheidet
Ein klassisches Theme besteht aus PHP-Vorlagen plus functions.php, und die Hierarchie oben ist das gesamte Routing. Ein Block-Theme besteht aus HTML-Dateien in einem Verzeichnis templates/ plus einer theme.json, bearbeitet im Website-Editor statt in einer Datei, und dieselbe Hierarchie gilt weiter, nur mit .html statt .php.
Der Unterschied zeigt sich in einer einzigen Verzeichnisauflistung: theme.json und templates/index.html vorhanden heißt Block-Theme, nur index.php und functions.php heißt klassisch. Sabine Runge betreut in Görlitz die Website eines Kulturvereins, dessen Theme klassisch ist, mit index.php, functions.php und style.css, ohne theme.json. Die meisten veröffentlichten Anleitungen behandeln eine der beiden Arten, ohne zu sagen, welche.
Was 2026 zum Einsatz kommt
Ein Child-Theme ist das Werkzeug, wenn das Theme jemand anderem gehört, kostenlos mit WordPress: ein Verzeichnis mit einer style.css, die das übergeordnete Theme benennt, und einer functions.php, und jede hinzugefügte Vorlagendatei überschreibt die Version des übergeordneten Themes. Es hat das Bearbeiten des übergeordneten Themes abgelöst, das bei der nächsten Aktualisierung verlorengeht, und es ist die nützlichste Konvention in WordPress.
Query Monitor nennt die Vorlage, die für die aktuelle Anfrage tatsächlich lief, kostenlos, und macht aus der Liste oben eine Beobachtung statt einer Vermutung. Es hat das Einbauen von Testausgaben in jede infrage kommende Datei ersetzt, und es nennt auch, aus welchem übergeordneten oder Child-Verzeichnis die Vorlage kam.
Wo die falsche Datei bearbeitet wird
Der Stall ist, eine Datei zu bearbeiten, die gar nicht läuft. Eine Änderung an single.php bewirkt nichts, weil eine single-post.php existiert, oder weil das Theme ein Child ist und die bearbeitete Datei dem übergeordneten Theme gehört. Nichts meldet einen Fehler, die Änderung hat einfach keine Wirkung, und die natürliche Reaktion ist eine noch größere Änderung.
Vor jeder Bearbeitung lohnt sich ein Blick darauf, welche Vorlage für diese URL läuft, eine Zeile in Query Monitor, die die ganze Fehlerklasse beseitigt. Wie ein Plugin in diese Vorlagen eingreift, statt in ihnen zu wohnen, ist die andere Hälfte der Schichtregel, und wie dieselbe Installation Inhalte über die REST-Schnittstelle statt über eine Vorlage ausliefert, ist die dritte.