Plugins y Temas para WordPress

Cómo funciona la jerarquía de plantillas WordPress

Post actualizado el día octubre 25, 2026 by DeiviSanzPlay

Si tu web no muestra lo que esperas y culpas al hosting, al plugin de turno o a Google, para. El problema casi siempre está en la jerarquía de plantillas de WordPress. Es el mecanismo que decide qué archivo pinta cada URL, y si lo ignoras, estás dejando tu SEO en manos del azar.

Me pasó diseñando una web de viajes. Toqué el single.php del tema padre y no cambiaba nada. Perdí dos horas. El culpable: WordPress estaba usando un single-viajes.php que ni recordaba haber creado. Ahí entendí que esto no es magia negra, es un sistema predecible que conviene dominar.

Cómo funciona realmente la jerarquía de plantillas en WordPress

Cuando alguien entra en tusitio.com/viajes/egipto/, WordPress no adivina. Ejecuta una lista ordenada de candidatos y usa el primero que exista. Esa lista es la jerarquía de plantillas de WordPress, y va de lo más específico a lo más genérico.

Para una entrada individual, el orden real es: single-post-tipo-de-entrada.php → single-post.php → single.php → singular.php → index.php. Si tu tema no tiene ninguno de los específicos, cae al index.php y punto. Por eso a veces ves un diseño genérico donde esperabas uno personalizado.

En categorías el patrón se repite: category-viajes.php → category-15.php (por ID) → category.php → archive.php → index.php. Si no tienes category-viajes.php, WordPress no se bloquea: baja al siguiente escalón sin avisar. Ese silencio es lo que confunde a tanta gente.

El error fatal que casi nadie detecta: plantillas guardadas en la base de datos

Aquí viene el giro que arruina SEO sin que te enteres. Desde WordPress 5.9, con los temas de bloques, puedes crear plantillas personalizadas desde el editor del sitio. Esas plantillas no se guardan como archivos, se guardan en la base de datos y tienen prioridad máxima.

Traducción: aunque tengas un single.php perfecto en tu tema hijo, si alguien guardó una plantilla personalizada para entradas en la base de datos, esa gana. Tu código no se ejecuta. Y tú mirando el FTP como un idiota.

Si un cambio no se refleja, lo primero que debes revisar no es el archivo, sino si existe una plantilla personalizada guardada en la base de datos tomando el control.

Esto es un arma de doble filo. Ganas flexibilidad para editar diseños sin tocar archivos, pero pierdes trazabilidad. En proyectos con varios editores es un caos garantizado si no hay disciplina.

Temas de bloques: la jerarquía cambia de forma, no de lógica

Con los block themes (temas de bloques) los archivos ya no son .php, son .html. No contienen código PHP complejo, contienen bloques. Y no van sueltos en la raíz del tema: viven en una subcarpeta llamada /templates/.

La jerarquía de plantillas en temas de bloques mantiene la misma filosofía: single-viajes.html gana a single.html, que gana a index.html. Pero se añade una capa nueva: las plantillas de la base de datos pisan a las del archivo. Si vienes de temas clásicos, este detalle te va a morder tarde o temprano.

Además, en temas de bloques puedes tener variaciones de plantilla. Una misma plantilla base con distintas configuraciones que el usuario elige. Eso significa que el archivo .html es solo el punto de partida, no la verdad absoluta.

Temas hijos: cuando la jerarquía se duplica y te juega una mala pasada

Usar un child theme es de primero de WordPress. Modificas sin romper el tema padre. Bien. Pero la jerarquía se ejecuta dos veces: primero en el hijo, luego en el padre.

Ejemplo práctico. Tienes single.php en el tema hijo. WordPress lo encuentra y lo usa. Perfecto. Pero si el tema padre tiene un single-receta.php y estás viendo una receta, ¿qué pasa? WordPress busca primero en el hijo: ¿existe single-receta.php en el hijo? No. ¿Existe en el padre? Sí. Lo usa. Tu single.php del hijo queda ignorado.

Este es el error al elegir plantilla de WordPress que más tiempo hace perder. No es que tu código esté mal, es que hay un archivo más específico en el padre que gana la partida. La solución no es borrar cosas a lo loco: es replicar ese archivo específico en el hijo y modificarlo ahí.

Checklist rápida para saber qué plantilla está usando WordPress

Antes de tocar nada, sigue este orden. Te ahorra horas y disgustos:

  • Activa la barra de depuración de plantillas con define(‘WP_DEBUG’, true); y revisa el cuerpo de la página: WordPress te dice qué archivo está usando.
  • Mira si hay plantillas personalizadas guardadas en la base de datos (editor del sitio, no archivos).
  • Comprueba el tema hijo antes que el padre, siempre.
  • Busca variantes específicas: single-{post_type}.php, category-{slug}.php, taxonomy-{taxonomy}-{term}.php.
  • Si nada coincide, el index.php es el responsable final.

Con esto dejas de dar palos de ciego. La jerarquía de plantillas WordPress no es un misterio, es una cascada con reglas claras. Y entenderla es la diferencia entre romper tu SEO sin saberlo y controlar exactamente qué ve Google en cada URL.

Por qué esto afecta directamente a tu SEO

Un tema mal elegido o una plantilla mal configurada puede cargar diseños genéricos donde debería haber contenido optimizado. Peor aún: puede duplicar contenido, generar títulos incorrectos o romper la estructura de encabezados H1-H2 en categorías clave.

Si tu página de categoría de viajes usa archive.php en lugar de category-viajes.php, probablemente estés mostrando extractos genéricos sin keyword, sin enlazado interno estratégico y sin metadatos diferenciados. Google lo detecta. Y posiciona peor.

La próxima vez que una página no se vea como esperas, no toques el CSS a lo loco. Pregúntate: ¿qué archivo está buscando WordPress en su jerarquía y cuál es el primero que realmente encuentra? Ahí está el 90% de los problemas.