- HTML Images
- Example
- Example
- Example
- HTML Images Syntax
- Syntax
- The src Attribute
- Example
- The alt Attribute
- Example
- Example
- Image Size — Width and Height
- Example
- Example
- Width and Height, or Style?
- Example
- Images in Another Folder
- Example
- Images on Another Server/Website
- Example
- Animated Images
- Example
- Image as a Link
- Example
- Image Floating
- Example
- Common Image Formats
- Chapter Summary
- HTML Exercises
- HTML Image Tags
- HTML Tag
- Browser Support
- Attributes
- HTML Tag
- Example
- More Examples
- Code Explanation
- Obsolete Attributes
- Additional Examples
- How to center an image
- Did you know?
- Alternative images instead of alternative text
- Media Tags
HTML Images
Images can improve the design and the appearance of a web page.
Example
Example
Example
HTML Images Syntax
The HTML tag is used to embed an image in a web page.
Images are not technically inserted into a web page; images are linked to web pages. The tag creates a holding space for the referenced image.
The tag is empty, it contains attributes only, and does not have a closing tag.
The tag has two required attributes:
Syntax
The src Attribute
The required src attribute specifies the path (URL) to the image.
Note: When a web page loads, it is the browser, at that moment, that gets the image from a web server and inserts it into the page. Therefore, make sure that the image actually stays in the same spot in relation to the web page, otherwise your visitors will get a broken link icon. The broken link icon and the alt text are shown if the browser cannot find the image.
Example
The alt Attribute
The required alt attribute provides an alternate text for an image, if the user for some reason cannot view it (because of slow connection, an error in the src attribute, or if the user uses a screen reader).
The value of the alt attribute should describe the image:
Example
If a browser cannot find an image, it will display the value of the alt attribute:
Example
Tip: A screen reader is a software program that reads the HTML code, and allows the user to «listen» to the content. Screen readers are useful for people who are visually impaired or learning disabled.
Image Size — Width and Height
You can use the style attribute to specify the width and height of an image.
Example
Alternatively, you can use the width and height attributes:
Example
The width and height attributes always define the width and height of the image in pixels.
Note: Always specify the width and height of an image. If width and height are not specified, the web page might flicker while the image loads.
Width and Height, or Style?
The width , height , and style attributes are all valid in HTML.
However, we suggest using the style attribute. It prevents styles sheets from changing the size of images:
Example
Images in Another Folder
If you have your images in a sub-folder, you must include the folder name in the src attribute:
Example
Images on Another Server/Website
Some web sites point to an image on another server.
To point to an image on another server, you must specify an absolute (full) URL in the src attribute:
Example
Notes on external images: External images might be under copyright. If you do not get permission to use it, you may be in violation of copyright laws. In addition, you cannot control external images; they can suddenly be removed or changed.
Animated Images
HTML allows animated GIFs:
Example
Image as a Link
To use an image as a link, put the tag inside the tag:
Example
Image Floating
Use the CSS float property to let the image float to the right or to the left of a text:
Example
The image will float to the right of the text.
The image will float to the left of the text.
Tip: To learn more about CSS Float, read our CSS Float Tutorial.
Common Image Formats
Here are the most common image file types, which are supported in all browsers (Chrome, Edge, Firefox, Safari, Opera):
Abbreviation | File Format | File Extension |
---|---|---|
APNG | Animated Portable Network Graphics | .apng |
GIF | Graphics Interchange Format | .gif |
ICO | Microsoft Icon | .ico, .cur |
JPEG | Joint Photographic Expert Group image | .jpg, .jpeg, .jfif, .pjpeg, .pjp |
PNG | Portable Network Graphics | .png |
SVG | Scalable Vector Graphics | .svg |
Chapter Summary
- Use the HTML
element to define an image
- Use the HTML src attribute to define the URL of the image
- Use the HTML alt attribute to define an alternate text for an image, if it cannot be displayed
- Use the HTML width and height attributes or the CSS width and height properties to define the size of the image
- Use the CSS float property to let the image float to the left or to the right
Note: Loading large images takes time, and can slow down your web page. Use images carefully.
HTML Exercises
HTML Image Tags
Tag | Description |
---|---|
Defines an image | |
Defines an image map | |
Defines a clickable area inside an image map | |
Defines a container for multiple image resources |
For a complete list of all available HTML tags, visit our HTML Tag Reference.
HTML
Tag
The tag is used to embed an image in an HTML page.
Images are not technically inserted into a web page; images are linked to web pages. The tag creates a holding space for the referenced image.
The tag has two required attributes:
- src — Specifies the path to the image
- alt — Specifies an alternate text for the image, if the image for some reason cannot be displayed
Note: Also, always specify the width and height of an image. If width and height are not specified, the page might flicker while the image loads.
Tip: To link an image to another document, simply nest the tag inside an tag (see example below).
Browser Support
Attributes
Attribute | Value | Description |
---|---|---|
alt | text | Specifies an alternate text for an image |
crossorigin | anonymous use-credentials | Allow images from third-party sites that allow cross-origin access to be used with canvas |
height | pixels | Specifies the height of an image |
ismap | ismap | Specifies an image as a server-side image map |
loading | eager lazy | Specifies whether a browser should load an image immediately or to defer loading of images until some conditions are met |
longdesc | URL | Specifies a URL to a detailed description of an image |
referrerpolicy | no-referrer no-referrer-when-downgrade origin origin-when-cross-origin unsafe-url | Specifies which referrer information to use when fetching an image |
sizes | sizes | Specifies image sizes for different page layouts |
src | URL | Specifies the path to the image |
srcset | URL-list | Specifies a list of image files to use in different situations |
usemap | #mapname | Specifies an image as a client-side image map |
width | pixels | Specifies the width of an image |
HTML
Tag
The tag displays an image in a web page. Accepted image formats include gif, jpg and png. Most browsers also support newer formats: apng, avif, and webp.
Example
Using
The tag displays images in an HTML page. This element can load images from the site itself or from sites across the internet. Accepted image formats include gif, jpg and png. Newer images formats, apng, avif, and webp, are supported by most modern browsers.
Tip: Avoid using the following image formats: bmp, ico and tiff. They are outdated and modern browser support is limited.
More Examples
An with an alt attribute.
The alternative text only displays when the image cannot be loaded.
In this example, the image loads fine, so the alternative text is not visible.

Try it live Here is the same example, but with a misspelled image file name.
The alternative text is displayed, next to an icon of a broken image.

Code Explanation
src — required, defines the image URL or file path alt — this attribute sets the text to be displayed if there is a problem with the image
Attributes for
Attribute | Value | Description |
---|---|---|
src | URL | URL or path of the image to be displayed |
alt | text | Alternate text for when image cannot be displayed |
id | identifier | Defines a unique identifier for the img. |
class | classnames | Sets one or more CSS classes to be applied to the img. |
style | CSS-styles | Sets the style for the img. |
data-* | value | Defines additional data that can be used by JavaScript. |
hidden | hidden | Specifies whether the img is hidden. |
title | text | Sets a title that displays as a tooltip. |
loading | loading | Loads the image lazily or eagerly upon page load. |
height | pixels | Image height in pixels |
width | pixels | Image width in pixels |
ismap | ismap | Creates a server-side image map |
usemap | #mapname | Creates a client-side image map |
srcset | URL | URL or path set of the image to be used in different situations |
sizes | image sizes | Different image sizes |
crossorigin | anonymous use-credentials | Specifies whether the image is requested using a cross-server request which can then be used in a element |
Obsolete Attributes
Attribute | Description | Alternative |
---|---|---|
align | Aligns the image relative to its surrounding elements. | CSS float, CSS vertical-align |
border | Sets the thickness of the image border. | CSS border |
hspace | Horizonal spacing in pixels, left and right of image. | CSS margin |
longdesc | URL of a detailed description of the image. | n/a |
name | The name of the image. | id attribute |
vspace | Vertical spacing in pixels, top and bottom of image. | CSS margin |
Additional Examples

How to center an image
Did you know?
Alternative images instead of alternative text
If an image fails to load, the alternative text defined on the alt attribute is displayed. However, an alternative image can also be defined with an element.
Try it live Note: If the image provided in the element is also broken, then the inside alt attribute value will be displayed.
Media Tags
The tag is part of a group of tags that create multi-media experiences on the web. This group is referred to as the Media tag group. Together, they allow you to create powerful multi-media solutions.
Here is a list of media tags.
Element | Description |
---|---|
Creates a player for sound such as music, sound effects, or others | |
Creates a video player on a page | |
Adds a media source for a , , or | |
Adds a text track, such as, subtitles and captions, to the media | |
Creates a container for an external resource | |
Creates a frame in which another web page can be embedded | |
Displays an scalable vector image | |
Creates a graphics container where JavaScript can draw | |
Displays an image | |
Specifies a map area for an image | |
Defines a client-side image map, i.e. an image with clickable areas | |
Displays self-contained content, usually an image | |
Adds a caption to a (image) element |