Referencias en YAML: Reutilización de datos y simplificación de configuraciones

Este artículo puede contener enlaces de afiliado. Si compras desde estos enlaces, el precio para ti es el mismo y la tienda me paga una pequeña comisión que ayuda a mantener Tecnoyfoto.

Albert BarnosellEditor y responsable de Tecnoyfoto

Revisión técnica: 27 de octubre de 2026. Esta es una guía complementaria procedente del curso anterior, no un capítulo numerado del nuevo. Para seguir el itinerario, consulta el curso actual de YAML en Home Assistant.

En YAML, las referencias se forman con un ancla y un alias. Reutilizan un nodo ya definido dentro del documento; no ejecutan acciones ni convierten una configuración genérica en una integración válida. Esta página se conserva mientras se decide su consolidación con la guía de anclas.

Sintaxis: ancla y alias

umbral: &temperatura_objetivo 21
otro_umbral: *temperatura_objetivo

Es un ejemplo genérico de datos: no debes pegar esas claves arbitrarias en configuration.yaml. El alias debe aparecer después del ancla y no se resuelve automáticamente entre archivos cargados por separado.

Un ejemplo válido en el editor de scripts

alias: "Referencia a un mensaje"
sequence:
  - action: persistent_notification.create
    data:
      message: &texto_aviso "Ejemplo de referencia YAML"
  - action: persistent_notification.create
    data:
      message: *texto_aviso

Aquí el ancla ocupa un campo real admitido por la acción. Se reutiliza el texto completo; no se concatena un sufijo ni se consulta una variable dinámica. Las dos acciones del ejemplo crean notificaciones.

Combinar mapas no es combinar listas

La extensión <<, cuando el cargador la admite, combina mapas. No puede utilizarse como actions: <<: *lista para desplegar una secuencia. Un alias puede representar una lista completa si el campo la espera, pero no añade sus elementos a otra por arte de magia.

También se han retirado los ejemplos antiguos con common_mqtt:, constants: y plataformas de luces presentadas como configuración universal: eran estructuras que no cumplían el esquema real de Home Assistant. Para ejemplos completos y límites de la combinación, consulta la guía corregida de anclas y alias. Para rutinas reutilizables, utiliza scripts.

Continúa leyendo

Siguiente guía relacionada · 2 min de lectura

Importación de archivos YAML en Home Assistant

Revisión técnica: 27 de octubre de 2026. Esta es una guía complementaria procedente del curso anterior, no un capítulo numerado del nuevo. Para seguir…

Continuar con este artículo↓