Note: This documentation is for the old 0.2.0 version of A-Frame. Check out the documentation for the current 0.5.0 version

The image primitive displays an image on a flat plane. It is an entity that prescribes the geometry with its geometric primitive set to plane.


<img id="my-image src="image.png">
<!-- Using the asset management system. -->
<a-image src="#my-image"></a-image>
<!-- Defining the URL inline. Not recommended but more comfortable for web developers. -->
<a-image src="another-image.png"></a-image>


Note that the image primitive inherits common mesh attributes.

AttributeComponent MappingDefault Value


Ensuring that the image is not distorted by stretching requires us to approriately set the width and height.

<a-image src="#logo" width="200" height="100"></a-image>