<a-plane>

NOTE: This version of the documentation tracks unstable development happening on A-Frame’s master branch. If you wish to try it out, grab the unstable build. Otherwise, head to the documentation for the current 1.7.0 version

The plane primitive creates flat surfaces using the geometry component with the type set to plane.

Example

<a-scene>
  <a-assets>
    <img id="ground" src="ground.jpg">
  </a-assets>

  <!-- Basic plane. -->
  <a-plane color="#CCC" height="20" width="20"></a-plane>

  <!-- Textured plane parallel to ground. -->
  <a-plane src="#ground" height="100" width="100" rotation="-90 0 0"></a-plane>
</a-scene>

Attributes

Attribute	Component Mapping	Default Value
alpha-test	material.alphaTest	0
ambient-occlusion-map	material.ambientOcclusionMap	None
ambient-occlusion-map-intensity	material.ambientOcclusionMapIntensity	1
ambient-occlusion-texture-offset	material.ambientOcclusionTextureOffset	0 0
ambient-occlusion-texture-repeat	material.ambientOcclusionTextureRepeat	1 1
anisotropy	material.anisotropy	0
blending	material.blending	normal
color	material.color	#FFF
depth-test	material.depthTest	true
depth-write	material.depthWrite	true
displacement-bias	material.displacementBias	0.5
displacement-map	material.displacementMap	None
displacement-scale	material.displacementScale	1
displacement-texture-offset	material.displacementTextureOffset	0 0
displacement-texture-repeat	material.displacementTextureRepeat	1 1
dithering	material.dithering	true
emissive	material.emissive	#000
emissive-intensity	material.emissiveIntensity	1
env-map	material.envMap	None
flat-shading	material.flatShading	false
height	geometry.height	1
mag-filter	material.magFilter	linear
material-fog	material.fog	true
material-visible	material.visible	true
metalness	material.metalness	0
metalness-map	material.metalnessMap	None
metalness-texture-offset	material.metalnessTextureOffset	0 0
metalness-texture-repeat	material.metalnessTextureRepeat	1 1
min-filter	material.minFilter	linear-mipmap-linear
normal-map	material.normalMap	None
normal-scale	material.normalScale	1 1
normal-texture-offset	material.normalTextureOffset	0 0
normal-texture-repeat	material.normalTextureRepeat	1 1
offset	material.offset	0 0
opacity	material.opacity	1
repeat	material.repeat	1 1
roughness	material.roughness	0.5
roughness-map	material.roughnessMap	None
roughness-texture-offset	material.roughnessTextureOffset	0 0
roughness-texture-repeat	material.roughnessTextureRepeat	1 1
segments-height	geometry.segmentsHeight	1
segments-width	geometry.segmentsWidth	1
shader	material.shader	standard
side	material.side	front
spherical-env-map	material.sphericalEnvMap	None
src	material.src	None
transparent	material.transparent	false
vertex-colors-enabled	material.vertexColorsEnabled	false
width	geometry.width	1
wireframe	material.wireframe	false
wireframe-linewidth	material.wireframeLinewidth	2

Parallelizing to the Ground

To make a plane parallel to the ground or make a plane the ground itself, rotate it around the X-axis:

<a-plane rotation="-90 0 0"></a-plane>