Guías · 4 min de lectura

Cómo poner un icono a tu módulo de Odoo

Dónde va icon.png, qué tamaño usa Odoo 17 y 18, cómo enlazarlo al menú con web_icon y por qué a veces no aparece tras actualizar.

Odoo muestra el icono de un módulo en dos sitios: la lista de Aplicaciones y, si el módulo tiene menú principal, el menú de inicio (la cuadrícula de apps). Los dos salen del mismo archivo.

1. Dónde va el archivo

Dentro de tu módulo, en static/description/icon.png. Odoo lo encuentra solo para la lista de Aplicaciones; no hay que declararlo en el __manifest__.py.

mi_modulo/
├── __init__.py
├── __manifest__.py
├── views/
│   └── menus.xml
└── static/
    └── description/
        ├── icon.png      ← 100 × 100 px, fondo transparente
        └── icon.svg      ← opcional, versión vectorial

2. Qué tamaño usar

Los módulos oficiales de Odoo 17 y 18 usan PNG de 100 × 100 px con fondo transparente. Desde la versión 17 el icono ya no lleva el recuadro de color de fondo de versiones anteriores: son formas planas directamente sobre el fondo del menú.

3. Enlazarlo al menú de inicio

Para que el icono aparezca en la cuadrícula de apps, el menú raíz del módulo debe declarar web_icon con el formato modulo,ruta:

<menuitem id="menu_mi_modulo_root"
          name="Mi Módulo"
          web_icon="mi_modulo,static/description/icon.png"
          sequence="50"/>

4. Actualizar y ver el cambio

1. Actualiza el módulo: desde Aplicaciones (botón Actualizar) o con odoo -u mi_modulo -d mi_base.
2. Recarga el navegador sin caché (Ctrl + Shift + R): el icono anterior suele quedar en la caché.
3. Si el icono del menú no cambia, revisa que web_icon esté en el menú raíz (sin parent) y que la ruta coincida exactamente, mayúsculas incluidas.

Errores frecuentes

• El icono se ve borroso: el PNG es más pequeño que 100 px o se exportó con fondo blanco.
• Aparece un icono genérico: el archivo no está en static/description/ o tiene otro nombre.
• Se ve distinto al resto de apps: lleva degradados, sombras, texto o un recuadro de fondo. Mira las reglas del estilo de Odoo 17+.