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 el itinerario, consulta el curso actual de YAML en Home Assistant.

Importar archivos YAML en Home Assistant sirve para organizar una configuración que ha crecido, no para cambiar automáticamente los tipos de sus datos. La directiva para cargar un archivo es !include. La numeración de este artículo pertenecía al curso antiguo.

Sintaxis correcta y contenido del archivo incluido

automation: !include automations.yaml
script: !include scripts.yaml
scene: !include scenes.yaml

Cada archivo debe contener exactamente el valor esperado en esa posición. Las automatizaciones y escenas se representan como listas; los scripts, como un mapa de identificadores. No repitas dentro del archivo la clave que ya aparece en configuration.yaml. No pegues el ejemplo si esas claves ya existen: adapta las entradas existentes.

Una lista y un mapa usan la misma directiva

scene: !include scenes_list.yaml
input_boolean: !include input_boolean_dict.yaml

El nombre del archivo no determina cómo se carga. En scenes_list.yaml iría una lista válida de escenas. En input_boolean_dict.yaml podría ir este mapa, sin la clave exterior input_boolean::

modo_visita:
  name: "Modo visita"
  icon: mdi:account-group

Corrección: no utilices !include_list ni !include_dict: no son las etiquetas incorporadas de Home Assistant. No hay que elegirlas según el tipo del archivo.

Si quieres organizar una carpeta completa

Directiva	Contenido y resultado
!include archivo.yaml	Carga un archivo. Conserva su estructura: lista, mapa o valor; no convierte una lista en mapa.
!include_dir_list carpeta/	Crea una lista cuyos elementos son los contenidos de los archivos. Si cada archivo contiene una lista, el resultado puede ser una lista de listas.
!include_dir_named carpeta/	Crea un mapa: cada nombre de archivo, sin extensión, es una clave.
!include_dir_merge_list carpeta/	Combina las listas de los archivos en una sola lista.
!include_dir_merge_named carpeta/	Combina los mapas de los archivos en un único mapa. Evita claves duplicadas.

Los detalles y ejemplos están en la guía corregida de inclusiones. No mezcles !include_dir_list y !include_dir_merge_list sin revisar si cada archivo contiene un elemento o una lista. Haz copia de seguridad y valida con Home Assistant antes de aplicar los cambios.

Referencia: documentación oficial de inclusiones de Home Assistant.