> For the complete documentation index, see [llms.txt](https://docs.colormass.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.colormass.com/building-blocks/integrations-and-plugins/blender-addon/hdris.md).

# HDRIs

The HDRI tools are in **Properties ▸ World ▸ colormass HDRI**. When the Shader Editor shows the world, you'll find the same tools in its sidebar's **colormass** tab.

![The colormass HDRI panel in the World properties](https://content.gitbook.com/content/v3R7xjvJcsIFNxg1zMmq/blobs/FTrwIcv8G9B1hIfY3S3q/images/world-panel.png)

## Use a platform HDRI as the world

{% stepper %}
{% step %}

## Enter the HDRI ID

Enter the **HDRI ID**, the number of the HDRI on the platform. The panel shows its name and organization.
{% endstep %}

{% step %}

## Download the HDRI

Click **Download HDRI as world**.
{% endstep %}
{% endstepper %}

The HDRI becomes the world of your scene, set up the way the platform renders it. Two node groups hold the settings you know from the platform's HDRI light:

* **HDRI Direction:** rotation and mirror.
* **HDRI Light:** saturation and intensity.

![A platform HDRI as the world, in the Shader Editor](https://content.gitbook.com/content/v3R7xjvJcsIFNxg1zMmq/blobs/R9sJaXvourZ4jez1DtBO/images/world-nodes.png)

The panel shows which HDRI the world uses, for example "Shows HDRI 15 from Production".

## Use your own HDRI file

Click **HDRI World From File** and choose an EXR or HDR file. The addon sets it up as the world with the same two node groups, so rotation, mirror, saturation and intensity are at hand.

## Upload a world as a new HDRI

Click **Upload World as New HDRI**, give the HDRI a name and choose its organization. This creates a new HDRI on the platform from the image the world shows. HDRIs already on the platform stay as they are.

![Uploading the world as a new HDRI](https://content.gitbook.com/content/v3R7xjvJcsIFNxg1zMmq/blobs/RniQD861FZqMMqTSNp6u/images/hdri-upload.png)

Only the image becomes the HDRI. Rotation, mirror, saturation and intensity are settings of the HDRI light in a template. They go along when you send the world to the template editor.

## Send the world to the template editor

Click **Send World to Template Editor** to add the world to the connected template as a new HDRI light, with its rotation, mirror, saturation and intensity. If the platform doesn't have the image yet, the addon uploads it as a new HDRI first. For sending, you need to connect the template editor, see [*Scenes*](/building-blocks/integrations-and-plugins/blender-addon/scenes.md).

## What the platform can take

The platform's HDRI light shows one image, which it can turn, mirror, desaturate and brighten. The addon refuses a world that does more, and tells you why. A world can be uploaded or sent when:

* it uses nodes, with a single Background shader and no volume;
* it shows one Environment Texture with an EXR or HDR file in equirectangular projection, read as linear;
* the image is only rotated about its centre or mirrored, not moved or stretched;
* colours change only in saturation and brightness.

Worlds set up with the colormass tools always meet these rules.