Adding Images With <img> and the alt Attribute
Adding Images With <img> and the alt Attribute
~8 Min. Lesezeit Zuletzt aktualisiert am August 8, 2026
A website with only text gets boring after a while. In this chapter you'll learn how to add images - one of the most important elements for making a website feel alive.
The <img> element
<img src="ball.jpg" alt="A white football on a green pitch">Just like <br> and <hr>, there's no closing tag - <img> is a single, self-closing element. Two attributes are new here:
src("source"): the path to the image file - exactly likehreffor links, this can be a relative path (your own file) or an absolute path (someone else's website).alt("alternative text"): a text description of the image.
Why the alt attribute matters so much
The alt attribute has three important jobs:
- People who are blind or have low vision have websites read aloud by a screen reader. The screen reader reads out the
alttext, since it obviously can't "see" the image itself. - If an image fails to load for some reason (wrong file name, slow internet), the browser shows the
alttext instead. - Search engines like Google read the
alttext to understand what an image shows - this helps your page get found.
Achtung: alt is not an optional extra - it belongs on every image. A good description is short and specific: "A white football on a green pitch" is good, "Image" or "Photo1" is not.
Creating an images folder
Before we can add an image, we need one. Create a new subfolder called images in your project folder and put a photo there (for example your own photo, or an image you're legally allowed to use - more on that in the next chapter).
Your project folder with a subfolder for images:
my-website/
index.html
players.html
images/
ball.jpgRelative paths into a subfolder
To reference a file inside a subfolder, write the folder name, a forward slash, then the file name:
<h2>Our Ball</h2>
<img src="images/ball.jpg" alt="A white football on a green pitch">Save and look at the image in your browser. If the image doesn't show up, check closely: is the file really inside images/? Is the file name (including capitalisation and the file extension like .jpg or .png) spelled exactly right?
Tipp: If an image refuses to show: the browser displays a small broken-image icon along with the alt text when an image is missing - that's a handy tool for quickly seeing that something's wrong.