<a-obj-model>

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.6.0 version

We recommend glTF for distributing assets in production over the web. Check out using the glTF model primitive. You can either instead export to COLLADA and use the converter or try out the OBJ converter.

The .OBJ model primitive displays a 3D Wavefront model.

Example

<a-scene>
<a-assets>
<a-asset-item id="crate-obj" src="crate.obj"></a-asset-item>
<a-asset-item id="crate-mtl" src="crate.mtl"></a-asset-item>
</a-assets>

<!-- Using the asset management system. -->
<a-obj-model src="#crate-obj" mtl="#crate-mtl"></a-obj-model>

<!-- Defining the URL inline. Not recommended but may be more comfortable. -->
<a-obj-model src="crate.obj" mtl="crate.mtl"></a-obj-model>
</a-scene>

Attribute

Attribute Component Mapping Default Value
mtl obj-model.mtl null
src obj-model.obj null

Troubleshooting

See Introduction → 3D Models → Troubleshooting.