W3Schools.com

HTML <img> Tag

Example

How to insert an image:

<img src="smiley.gif" alt="Smiley face" height="42" width="42" />

Try it yourself »
(more examples at the bottom of this page)

Browser Support

Internet Explorer Firefox Opera Google Chrome Safari

The <img> tag is supported in all major browsers.

Definition and Usage

The <img> tag defines an image in an HTML page.

The <img> tag has two required attributes: src and alt.

Note: Images are not technically inserted into an HTML page, images are linked to HTML pages. The <img> tag creates a holding space for the referenced image.

Tip: To link an image to another document, simply nest the <img> tag inside <a> tags.

Differences Between HTML and XHTML

In HTML the <img> tag has no end tag.

In XHTML the <img> tag must be properly closed.

Required Attributes

DTD indicates in which HTML 4.01/XHTML 1.0 DTD the attribute is allowed. S=Strict, T=Transitional, and F=Frameset.

Attribute Value Description DTD
alt text Specifies an alternate text for an image STF
src URL Specifies the URL of an image STF

Optional Attributes

Attribute Value Description DTD
align top
bottom
middle
left
right		 Deprecated. Use styles instead.
Specifies the alignment of an image according to surrounding elements		 TF
border pixels Deprecated. Use styles instead.
Specifies the width of the border around an image		 TF
height pixels
%		 Specifies the height of an image STF
hspace pixels Deprecated. Use styles instead.
Specifies the whitespace on left and right side of an image		 TF
ismap ismap Specifies an image as a server-side image-map STF
longdesc URL Specifies the URL to a document that contains a long description of an image STF
usemap #mapname Specifies an image as a client-side image-map STF
vspace pixels Deprecated. Use styles instead.
Specifies the whitespace on top and bottom of an image		 TF
width pixels
%		 Specifies the width of an image STF

Standard Attributes

The <img> tag supports the following standard attributes:

Attribute Value Description DTD
class classname Specifies a classname for an element STF
dir rtl
ltr		 Specifies the text direction for the content in an element STF
id id Specifies a unique id for an element STF
lang language_code Specifies a language code for the content in an element STF
style style_definition Specifies an inline style for an element STF
title text Specifies extra information about an element STF
xml:lang language_code Specifies a language code for the content in an element, in XHTML documents STF

More information about Standard Attributes.

Event Attributes

The <img> tag supports the following event attributes:

Attribute Value Description DTD
onabort script Script to be run when loading of an image is interrupted STF
onclick script Script to be run on a mouse click STF
ondblclick script Script to be run on a mouse double-click STF
onmousedown script Script to be run when mouse button is pressed STF
onmousemove script Script to be run when mouse pointer moves STF
onmouseout script Script to be run when mouse pointer moves out of an element STF
onmouseover script Script to be run when mouse pointer moves over an element STF
onmouseup script Script to be run when mouse button is released STF
onkeydown script Script to be run when a key is pressed STF
onkeypress script Script to be run when a key is pressed and released STF
onkeyup script Script to be run when a key is released STF

More information about Event Attributes.

Examples

Try it Yourself - Examples

Insert images from different locations
How to insert images from another folder or from another web site.

Make a hyperlink of an image
How to add a hyperlink to an image.

Create an image map
How to create an image map, with clickable regions. Each region is a hyperlink.

W3Schools Certification

W3Schools' Online Certification

The perfect solution for professionals who need to balance work, family, and career building.

More than 10 000 certificates already issued!

Get Your Certificate »

The HTML Certificate documents your knowledge of HTML.

The CSS Certificate documents your knowledge of advanced CSS.

The JavaScript Certificate documents your knowledge of JavaScript and HTML DOM.

The jQuery Certificate documents your knowledge of jQuery.

The XML Certificate documents your knowledge of XML, XML DOM and XSLT.

The ASP Certificate documents your knowledge of ASP, SQL, and ADO.

The PHP Certificate documents your knowledge of PHP and SQL (MySQL).

WEB HOSTING
Best Web Hosting
PHP MySQL Hosting
Best Hosting Coupons
UK Reseller Hosting
Cloud Hosting
Top Web Hosting
$7.95/mo SEO Hosting
Premium Website Design
WEB BUILDING
Download XML Editor
FREE Website BUILDER
Free Website Templates Free CSS Templates
Make Your Own Website
W3SCHOOLS EXAMS
Get Certified in:
HTML, CSS, JavaScript, XML, PHP, and ASP
W3SCHOOLS BOOKS
New Books:
HTML, CSS
JavaScript, and Ajax
STATISTICS
Browser Statistics
Browser OS
Browser Display
SHARE THIS PAGE