diff --git a/docs/builder-fields.md b/docs/builder-fields.md
index 7c24ecf..f0c7755 100644
--- a/docs/builder-fields.md
+++ b/docs/builder-fields.md
@@ -429,6 +429,15 @@ Manejo automático de validación, almacenamiento en BD y envío de emails.
 
 ## MCP Tools: Config Vars e Imágenes de Módulos
 
+### Regla importante: Siempre rellenar variables al añadir un módulo
+Cuando se añade un módulo a una página (con `add_module_to_record`), este queda vacío y no muestra nada visible. **SIEMPRE** hay que llamar a `set_module_config_vars` inmediatamente después para rellenar las variables con contenido de ejemplo coherente con el contexto del sitio. Incluir:
+- Textos (títulos, descripciones, pretítulos) con contenido relevante al sitio
+- Valores de listas/selects con una opción válida
+- Para variables multi (records), crear al menos 2-3 items de ejemplo
+- Para variables de imagen (upload), usar `generate_image` o `upload_record_image` para que el módulo se vea completo
+
+Un módulo sin variables configuradas es invisible en la web.
+
 ### Leer variables de un módulo
 Antes de modificar cualquier módulo, usar `get_module_config_vars` para conocer el estado actual:
 - **tableName**: tabla del registro padre (ej: `apartados`), SIN prefijo `cms_`