Home Assistant 2025.12: cómo arreglar las plantillas heredadas antes de que tus sensores fallen

¿Te ha salido el aviso de “Plantilla heredada de sensor obsoleta” después de actualizar Home Assistant a la versión 2025.12 de diciembre? No es un simple mensaje informativo. Si no haces nada, algunos de tus sensores dejarán de funcionar en junio de 2026.

En esta guía verás qué significa ese aviso, qué sensores se verán afectados, cómo localizar el problema en tu configuración y cómo migrar, paso a paso, a la sintaxis moderna de template: sin perder nada. Todo usando ejemplos reales y con un flujo de trabajo sencillo.

El aviso tras actualizar a Home Assistant 2025.12

Al actualizar a la versión 2025.12 (a veces verás algo como 12.2025 o 1225), muchos usuarios están viendo un mensaje de advertencia del estilo:

“Plantilla heredada, sensor obsoleta”
“The legacy platform: template syntax for sensor is being removed”

Este aviso aparece en la zona de Configuración, dentro de Sistema, normalmente en la parte de Reparaciones o Notificaciones. Puede que te aparezcan varios mensajes, uno por cada sensor afectado.

[Aquí iría una captura de pantalla del aviso de “Plantilla heredada de sensor obsoleta” en Home Assistant]

Cuando abres el detalle del aviso, Home Assistant te indica que:

• Ese tipo de plantilla está obsoleta.
• Dejará de funcionar aproximadamente en junio de 2026.
• Tienes que actualizar la configuración a la sintaxis moderna.
• Te muestra directamente el código nuevo recomendado, listo para copiar y pegar.

Este problema afecta a quienes tienen sensores de plantilla definidos con la sintaxis antigua dentro de:

• El bloque sensor: de configuration.yaml.
• Ficheros incluidos como sensors.yaml (por ejemplo con !include sensors.yaml).

Si nada de esto te suena, es bastante posible que igualmente tengas algo de ese código heredado, sobre todo si llevas tiempo usando Home Assistant o has copiado fragmentos antiguos de foros o tutoriales.

Qué sensores se eliminan y por qué Home Assistant cambia la sintaxis

Home Assistant está retirando las plantillas heredadas de sensor que usan la antigua forma de configuración con platform: template dentro del bloque sensor:. Ese formato fue muy común durante años, pero ahora se considera obsoleto.

Sintaxis antigua frente a sintaxis moderna

Antes, la forma típica de crear sensores de plantilla era:

• Dentro de sensor:.
• Con platform: template.
• Usando value_template: para definir el valor.

La estructura general era algo como:

• sensor:
  • - platform: template
    • definición de sensores y value_template.

La sintaxis moderna funciona de otra forma:

• Todo lo que sea plantilla se declara en la sección template:.
• Dentro de esa sección se definen los sensor: de plantilla.
• Lo que antes era value_template: ahora se expresa con state:.

Podemos resumir el cambio en esta tabla:

Antes (heredado)	Ahora (moderno)
Bloque sensor: con - platform: template	Bloque template: en la raíz de configuración
Uso de value_template: para el valor del sensor	Uso de state: para el valor del sensor
Todo mezclado con otros sensores físicos en sensor:	Todo agrupado dentro de template:

Hay elementos que se mantienen en ambos casos, por ejemplo:

• name
• unit_of_measurement
• device_class
• state_class
• default_entity_id (si lo estás usando)

En el vídeo se muestra un ejemplo real con dos sensores que calculan el precio de la luz usando plantillas. En el caso mostrado, esos sensores estaban definidos en un fichero sensors.yaml que se incluía desde configuration.yaml.

Aunque uses includes como sensors.yaml, la solución es la misma: mover esa plantilla a la sección template.

El objetivo de Home Assistant con este cambio es unificar toda la lógica de plantillas bajo template:, simplificar el sistema y evitar duplicidades de sintaxis.

Cómo saber si tu instalación está afectada

Antes de tocar archivos, conviene confirmar si tu configuración usa estas plantillas heredadas.

1. Revisa los avisos de Home Assistant

Entra en:

• Configuración
• Sistema

Y mira en:

• Reparaciones
• Notificaciones

Si ves mensajes del tipo:

• “Plantilla heredada, sensor obsoleta”
• “The legacy platform: template syntax for sensor is being removed”

haz clic en cada uno. Dentro verás:

• El nombre del sensor afectado.
• Una explicación de que dejará de funcionar en el futuro.
• Un bloque con la configuración recomendada nueva, ya en formato template:.

2. Revisa tu archivo configuration.yaml

Abre tu configuration.yaml con tu editor habitual y busca:

• Algún bloque sensor: que contenga platform: template.
• Algún !include sensors.yaml o algo parecido, como !include_dir_merge_list.

Ejemplos de cosas a localizar:

• sensor: seguido de - platform: template.
• Un !include sensors.yaml que apunta a un archivo con sensores.

Si encuentras algo de esto, es casi seguro que tendrás que migrarlo.

3. Revisa tus includes de sensores

Si tienes un fichero sensors.yaml o similar:

• Ábrelo.
• Busca dentro bloques con platform: template y plantillas asociadas.

Es justo lo que se muestra en el ejemplo del vídeo: un fichero sensors.yaml con dos sensores para el precio de la luz, ambos definidos con platform: template.

Paso a paso: migrar tus sensores heredados

La solución no es complicada, pero conviene hacerlo con orden para no romper nada.

Paso 1: localizar y guardar el código antiguo

Cuando identifiques un sensor afectado:

1. Localiza el bloque completo donde está definido.
2. Selecciona todo ese código.
3. Cópialo y pégalo en un archivo de texto aparte, como copia de seguridad.

Esto es importante por si necesitas comparar después o restaurar algo. En el caso del ejemplo, se guardaron los dos sensores antiguos de PVPC en un fichero de texto antes de borrarlos.

Paso 2: borrar el bloque antiguo del apartado sensor

Una vez tengas copia:

• Ve al archivo donde está el bloque antiguo (configuration.yaml o sensors.yaml).
• Elimina el bloque que usa sensor: con platform: template.
• Guarda el archivo sin ese código.

La idea es que no quede ninguna plantilla de tipo:

• sensor: con - platform: template dentro.

porque eso es lo que Home Assistant va a dejar de soportar.

Paso 3: usar o crear tu fichero de plantillas (templates.yaml)

En el ejemplo del vídeo, ya existía una sección de plantillas en configuration.yaml, algo del estilo:

• Un include hacia un fichero de plantillas, por ejemplo templates.yaml.

Revisa tu configuration.yaml y mira si tienes algo parecido a:

• template: !include templates.yaml
• O un bloque template: con contenido.

Si ya tienes un fichero de plantillas:

• Ábrelo, suele llamarse templates.yaml o similar.
• Verás que dentro hay definiciones de plantillas, por ejemplo otros sensores.

Si no lo tienes, puedes:

• Crear un bloque template: directamente en configuration.yaml.
• O crear un fichero templates.yaml y añadir un include desde configuration.yaml.

La idea es que, a partir de ahora, todas las plantillas vayan dentro de template:, no dentro de sensor:.

Paso 4: copiar el nuevo código generado por Home Assistant

Ahora toca aprovechar la parte más cómoda: Home Assistant te da el código nuevo ya preparado.

Para cada aviso:

1. Entra en el mensaje de advertencia.
2. Copia el bloque de configuración que te propone.
3. Si estás pegando dentro de un fichero que ya es de plantillas (por ejemplo templates.yaml), no repitas la palabra template: si ya la tienes.
4. Pega el contenido comenzando directamente por sensor: dentro de ese fichero.

En el vídeo se ve exactamente esto: el fichero templates.yaml ya tenía una estructura de plantillas, así que se pegaron los nuevos sensores empezando por sensor:.

Además, el autor aprovecha para dar un poco de orden a las claves, por ejemplo:

• Poner name: en primer lugar.
• Luego unit_of_measurement si la hay.
• Después default_entity_id si lo usas.
• Y por último la parte de state: con la plantilla.

Puedes seguir un criterio parecido para que tu código sea más legible.

Paso 5: ordenar el código para que sea fácil de leer

El código que genera Home Assistant en el aviso funciona, pero suele venir:

• Todo en una sola línea en la parte de state.
• Sin tabulación clara.
• Con un orden de claves que tal vez no te guste.

Puedes:

• Dividir la línea de la plantilla si es muy larga.
• Alinear sangrías para que se vea qué pertenece a qué.
• Dejar espacios en blanco entre sensores diferentes.

En el ejemplo, se cogió el código tal como lo generó Home Assistant y se reordenó para que quedara claro y bien tabulado, manteniendo la misma lógica interna.

Paso 6: reiniciar Home Assistant y comprobar

Con todo ya pegado en template::

1. Ve a Configuración.
2. Entra en Sistema.
3. Haz un reinicio de Home Assistant.

Mientras se reinicia verás el típico aviso de “conexión perdida”. Cuando vuelva a cargar:

• Entra de nuevo en Configuración > Sistema > Reparaciones.
• Comprueba si el aviso de “Plantilla heredada de sensor obsoleta” ha desaparecido.

Si todo está correcto:

• Ya no verás esos avisos.
• Tus sensores seguirán apareciendo en los paneles de visualización.
• El histórico de esos sensores seguirá funcionando con normalidad.

En el ejemplo, tras el reinicio, los dos sensores de precio de la luz continuaban actualizando sus valores como siempre, solo que ahora con la sintaxis moderna.

Ejemplo real: migrando sensores del precio de la luz (PVPC alternativa)

En el caso mostrado en el vídeo, la migración se hace sobre dos sensores de plantilla que calculan:

• El precio de la luz con una alternativa a PVPC.

Estos sensores estaban:

• Definidos en sensors.yaml.
• Declarados con platform: template dentro del bloque sensor:.
• Usados en paneles de visualización para seguir el coste de la electricidad.

El proceso seguido fue:

1. Localizar y copiar esos dos sensores antiguos desde sensors.yaml.
2. Borrarlos de sensors.yaml y guardar el archivo sin ellos.
3. Abrir el fichero de plantillas, por ejemplo templates.yaml.
4. Desde los avisos de Home Assistant, copiar el nuevo código que aparecía en la sección de detalle de cada aviso.
5. Pegar esos bloques en templates.yaml, ajustando un poco el orden de las claves para que quedara más limpio.
6. Guardar cambios y reiniciar Home Assistant.

El resultado:

• Los avisos de plantillas heredadas desaparecen.
• Los dos sensores siguen apareciendo como antes.
• El histórico de datos se mantiene.

En resumen, los sensores siguen funcionando con absoluta normalidad después de la migración, solo que usando la sintaxis moderna recomendada por Home Assistant.

Aunque hoy en día existen integraciones y módulos más completos para el precio de la luz, si ya tienes sensores de plantilla que te funcionan y solo quieres evitar que se rompan, este método te sirve perfectamente.

Consejos útiles y errores frecuentes

Para que la migración te resulte más sencilla, ten en cuenta estos puntos:

• Haz siempre una copia de seguridad de tus archivos de configuración antes de borrar nada.
• No dejes el mismo sensor definido a la vez en sensor: con platform: template y en template:. Quédate solo con la versión moderna.
• Revisa bien la sangría de YAML, un espacio de más o de menos puede dar errores al arrancar.
• Después de migrar, ve a tus paneles de Lovelace y comprueba que esos sensores siguen mostrando datos y que el histórico se actualiza.
• Si Home Assistant te da el código ya generado en el aviso, úsalo. Es el más cercano a lo que el propio sistema espera.
• Aunque el plazo hasta junio de 2026 parece largo, es mejor migrar ahora, mientras tienes el aviso bien claro y el código sugerido a mano.

Cuanto antes hagas estos cambios, menos sorpresas tendrás cuando lleguen futuras versiones.

Comunidad, soporte y descuentos para tus compras

Si te gusta trastear con Home Assistant, domótica, servidores o informática en general, no hace falta que lo hagas solo. Hay una comunidad bastante activa alrededor del creador del vídeo que puede ayudarte y donde tú también puedes ayudar a otros.

• Puedes unirte a la comunidad de Telegram de Javier Gutiérrez, donde ya hay más de 300 personas comentando problemas, soluciones e ideas, a través del grupo de Telegram del canal JGA.
• Tienes también el foro con tutoriales, fotos, guías y, muy interesante, una sección de chollos y descuentos. Lo encontrarás en el foro de Spyfly.
• En el foro hay una recopilación de cupones de AliExpress con descuentos de 5, 10, 20 y hasta 40 euros según el importe de tu compra. Solo eliges un cupón, lo pones al pagar y se aplica el descuento automáticamente, sin trucos raros.

Si te gusta leer artículos más largos, también tienes el blog de Javier Gutiérrez, con contenido sobre tecnología, domótica y muchos otros temas relacionados.

Y si quieres seguir las novedades en redes:

• TikTok: perfil de Javier en TikTok
• LinkedIn: perfil profesional en LinkedIn
• Facebook: página oficial en Facebook
• Instagram: cuenta de Instagram
• Threads: perfil en Threads
• X (Twitter): cuenta en X de Javier
• YouTube: canal de YouTube de Javier Gutiérrez Abella

Si vas a comprar en AliExpress de forma habitual, usar los cupones del foro es una manera muy sencilla de ahorrar unos cuantos euros en cada pedido.

Conclusión

Las plantillas heredadas de sensor con platform: template tienen fecha de caducidad y dejarán de funcionar en Home Assistant a partir de junio de 2026. La buena noticia es que migrarlas a la sintaxis moderna de template: es un proceso directo si sigues los pasos correctos y aprovechas el código que el propio sistema te ofrece en los avisos.

Dedicar unos minutos ahora te ahorrará problemas en futuras actualizaciones y te evitará un posible “apagón” de sensores clave en tu instalación domótica. Si te ha servido esta guía, plantéate suscribirte al canal de Javier, unirte a la comunidad de Telegram y echar un vistazo a los cupones del foro para tus próximas compras.

Gracias por llegar hasta aquí y, si ya has hecho la migración, cuéntalo y ayuda a otros usuarios que todavía están luchando con sus sensores de plantilla.