Inicio › Tutoriales › HTML

Cómo poner una imagen en HTML

Para mostrar una imagen en tu web solo necesitas una etiqueta: <img>. Aquí verás cómo usarla bien, cómo cambiar su tamaño y por qué a veces aparece el icono de imagen rota.

🖼️ HTML⏱ 4 min de lectura🟢 Nivel principiante
⚡ Respuesta rápidaAsí se pone una imagen:
<img src="foto.jpg" alt="Descripción de la foto" width="400">
✏️ Pruébalo: cambia el códigoAbrir en el editor grande

Los dos atributos que siempre necesitas

src (de source, origen) indica dónde está la imagen. Puede ser una dirección de internet completa (https://...) o el nombre de un archivo que está en la misma carpeta que tu página, como foto.jpg.

alt es un texto alternativo que describe la imagen. Lo leen las personas que usan lectores de pantalla, aparece si la imagen no carga y además ayuda a Google a entender qué hay en ella. No lo dejes vacío salvo que la imagen sea solo decorativa.

La etiqueta <img> no tiene cierre. No escribas </img>.

Cómo cambiar el tamaño

Tienes dos opciones. La rápida es usar los atributos width y height directamente en la etiqueta. La recomendada es hacerlo con CSS, porque así puedes hacer que la imagen se adapte al móvil:

img {
  max-width: 100%;
  height: auto;
}

Con max-width: 100% la imagen nunca será más ancha que su contenedor, y height: auto mantiene la proporción para que no se deforme.

Espacio publicitario

Cómo centrar una imagen

Las imágenes se comportan como texto, así que lo más sencillo es meterla en un contenedor con text-align: center. Otra opción es convertirla en bloque:

img {
  display: block;
  margin: 0 auto;
}

¿Por qué sale la imagen rota?

Casi siempre es un problema de la ruta en src: el nombre del archivo está mal escrito, falta la extensión (.jpg, .png), hay mayúsculas que no coinciden o la imagen está en otra carpeta. Si está dentro de una carpeta llamada img, la ruta sería img/foto.jpg.

Errores comunes

  • Escribir mal el nombre o la extensión del archivo.
  • Olvidar el atributo alt.
  • Poner a la vez width y height con valores que no respetan la proporción, y la imagen se deforma.
🎯 Mini reto: Añade un borde redondeado más grande y una sombra a la imagen. Pista: busca border-radius y prueba box-shadow: 0 8px 20px rgba(0,0,0,.3). Hazlo en el editor de arriba.

Preguntas frecuentes

¿Qué formatos de imagen puedo usar?

Los más comunes son JPG para fotos, PNG para imágenes con transparencia, SVG para iconos y logos, y WebP, que pesa menos y funciona en todos los navegadores actuales.

¿Cómo pongo una imagen que tengo en mi ordenador?

Guarda la imagen en la misma carpeta que tu archivo HTML y escribe su nombre en src, por ejemplo src="gato.png".

¿Cómo hago que una imagen sea un enlace?

Mete la etiqueta <img> dentro de un <a href="...">.

Espacio publicitario

Sigue aprendiendo