Textures and Materials
Environment Textures

Environment textures and the environment light

In Meta Spark Studio, you can use environment textures to mimic the light in a specific real world environment. This is also known as using image-based lighting.

You'll combine environment textures with the physically-based material in Meta Spark Studio.

You can either add environment textures to individual materials or to the whole scene.

How environment textures work

Environment textures are made from images that capture a scene - like an office or the beach on a sunny day - from all directions. For example, using the Office environment texture included in Meta Spark Studio would provide an object with similar lighting to an office.

Below, we've added an environment texture to the material applied to the object on the right:

A 3D model of an arm and hand. The model on the left os darker then the model on the right.

There are several environment textures built into Meta Spark Studio, and you can also add your own. Environment textures should be HDR images, and we recommend maximum 4K images.

Applying environment textures to individual materials

First add an environment texture to your project:

  1. Click + in the Assets panel.
  2. Select Environment Texture.
  3. Choose an option from AR Library.


  1. Select the physically-based material applied to the object in the Assets panel.
  2. In the Inspector, check the box next to Environment.
  3. Click the dropdown next to Texture and select the environment texture.
An environment texture being selected in the Properties panel.

If there's an environment light in the scene, you can still apply environment textures to single materials. Environment textures applied to individual objects will override the environment light.

Adding an environment light to the whole scene

Adding an environment light will apply environment textures to all objects in your scene that have a physically-based material.

  1. Click + in the Scene panel.
  2. Select Environment Light.
  3. In the Inspector, click the dropdown next to Texture.
  4. Either select an environment texture or import your own.
  5. For each material that you want to be affected by the environment light, make sure the box next to Environment is checked in the Inspector.

Importing environment textures

There's a huge range of environment textures to choose from on HDRI Haven and on other similar websites.


  1. Import the texture into the Assets panel by clicking + next to Assets, and selecting Import from Computer.
  2. Apply it directly to a material in the Inspector by selecting New Environment Texture from the dropdown under Environment.

The texture will be listed in the Assets panel. The image in the Assets panel won't look exactly like the texture you imported, because the texture undergoes some processing before it can be used as an environment texture in Meta Spark Studio.

Constraints and optimization

There can only be 1 environment light in a scene.

Environment textures can increase the size of your effect, which can impact performance.

We recommend:

  1. Including no more than 1 environment texture.
  2. Applying the same environment texture to each material in the scene.

Before you export your effect, make sure any unused environment textures have been removed from the Assets panel. Otherwise, they'll still be included in the overall size of your effect.