Latest news
TutorialsBlenderOMAMAS

Blender Cryptomatte guide: Masking objects and materials in a render

Blender Cryptomatte helps you select objects and materials in a render using separate masks. This guide explains how to enable the required render pass, make selections in the Compositor, and use the mask output.

Architectural visualization of a contemporary interior with individual elements clearly distinguishedAI image
Representative image, generated with AI.Image: 3dsınıfı / FCA AI

In brief

  1. Cryptomatte creates masks for one or more objects or materials in a render.
  2. To isolate objects, enable the Cryptomatte Object render pass under View Layer > Passes.
  3. The Matte output provides a grayscale mask; to use the Image output, connect the color render to the Cryptomatte node’s Image input.
  4. According to the Blender manual, Cryptomatte sidecar metadata files and volume objects are not supported.

What you’ll learn

This guide covers using Cryptomatte in the Blender Compositor to create masks for objects or materials in a render. At the end, you can get a grayscale mask for the selected items, or apply the mask to the color render to separate the selected areas from the rest of the image. This provides a starting point for working on specific parts of an image independently during compositing.

Cryptomatte addresses a similar need to the Object Index and Material Index passes. One difference highlighted in the Blender manual is that it can distinguish multiple objects in a single pixel. When using Cycles, the method can also work with transparency, motion blur, and depth of field. These capabilities can make masks useful in visualization work where edges and overlapping elements matter.

Requirements

This guide is based on the functionality described in Blender’s Cryptomatte Node and Passes manuals. Since the sources do not specify a particular Blender version, computing requirement, hardware requirement, or license fee, no such requirements are stated here.

You’ll need to render the scene and use Render Layers and Cryptomatte nodes in the Compositor. You can work with Blender’s own Cryptomatte render passes or use a Cryptomatte image from another standards-compliant application. If the image source is a multilayer OpenEXR, set the node’s Source to Image; when working with passes from Blender, you can use the Render source.

Step-by-step: Create an object mask

  1. Enable the appropriate Cryptomatte pass. Open the View Layer section in Properties and go to the Passes panel. Enable Cryptomatte Object to select objects. If you need to select by material, you can use Cryptomatte Material. Cryptomatte Asset is for separating groups of objects linked to the same parent; it does not mean the same thing as Blender’s asset feature.

  2. Render the scene. Render the scene after enabling the pass. Since selection and masking are performed using render data, this output is the basis for the following steps.

  3. Set up the Compositor nodes. In the Compositor, use a Cryptomatte Node and a Viewer Node to inspect the image. Connect the Image output of the Render Layers node to the Image input of the Cryptomatte node. This connection is required to get the color image with the mask applied from the node’s Image output. The Image input can be left empty if you only need a grayscale mask.

  4. Make the image visible for selection. Connect the Image output of the Render Layers node to the Image input of the Viewer. Alternatively, you can connect the Cryptomatte node’s Pick output to the Viewer; this output provides a color-coded view to help distinguish the objects or materials to select. If the image isn’t visible in the Compositor workspace, check whether Backdrop is enabled.

  5. Choose which items to include in the mask. Use the selection control on the Cryptomatte node to pick the target item in the image. Repeat the selection for each additional object you want to include in the mask. The names of selected items are stored as comma-separated entries in the Matte ID field. You can enter names in this field manually, but the Blender manual also shows how to use the plus and minus controls next to it.

  6. Choose the right output. The Cryptomatte node’s Matte output provides a grayscale mask of the selected objects or materials. To get a color image of the selected items with the other areas transparent, connect the Render Layers Image output to the Cryptomatte node’s Image input and use the node’s Image output. In other words, this second output is the result of applying the mask to the color render, not an image that can be used when the Image input is unconnected.

  7. Add the result to your compositing workflow. Use the Matte output when you need a mask for an area, or the Image output when you need an isolated image of the selected items. The appropriate output depends on the compositing task. The Cryptomatte node’s Source setting—Render or Image—also depends on the data being used; when Image is selected, you must also specify the Cryptomatte image to use.

Using Cryptomatte in architectural visualization workflows

In an interior or architectural scene, you may need to handle furniture, finishes, or another object separately after rendering. A Cryptomatte mask helps separate selected items from other parts of the image during compositing. For example, you can use the Matte output to assess a material group independently or mask specific objects for a different operation. This is an example of how pass and mask outputs might be used in a workflow; the sources do not prescribe a specific architectural project method.

Blender’s Passes manual notes that Cryptomatte is a standard that can also be used with other compositing applications. However, it does not provide a general guarantee of file compatibility across different applications. It’s therefore a good idea to test the compatibility of the software and image source your team plans to use before starting a project. Since the sources do not specify any special hardware requirements or license costs, no conclusions about purchasing or upgrading can be drawn here.

Common mistakes and limitations

  • Rendering without enabling the pass: Before selecting objects or materials, make sure the relevant Cryptomatte option is enabled under View Layer > Passes.

  • Using the Image output without a connection: A color render input is not required for the Matte output. However, to use the Image output—which provides a masked color image—you must connect a color render to the node’s Image input.

  • Unable to find the image in the Compositor: Check the Viewer connections and the Backdrop setting. You can also use the Pick output to inspect the selection view in the Viewer.

  • Expecting unsupported data to work: The Blender manual states that Cryptomatte sidecar metadata files are not supported and that volume objects cannot be used with the Cryptomatte node.

  • Assuming it behaves exactly like Index passes: Cryptomatte has a similar purpose to Object Index and Material Index, but Blender lists its ability to distinguish multiple objects in a single pixel as an advantage. Support for transparency, motion blur, and depth of field in Cycles is also noted.

Next steps

After creating an object mask, enable the Cryptomatte Material pass to apply the same approach to materials. When using the Asset pass, remember that it targets groups of objects linked to the same parent. A Cryptomatte Layer is typically a combination of a View Layer and an Object, Material, or Asset type.

You can also consider other render passes for a broader compositing workflow. Blender’s manual explains that data such as depth, normals, and light can be output as separate images and combined in custom ways in the Compositor. Checking what each pass provides and adding only the data you need to the workflow can help keep outputs easier to understand.

Sources and license

This tutorial has been adapted into Turkish from Blender’s Cryptomatte Node and Passes manuals. Both sources are published under the CC BY-SA 4.0 license.

Sources

2 sources
D(
docs.blender.org (CC BY-SA 4.0)docs.blender.org/manual/en/latest/compositing/types/mask/cryptomatte.html
Summary
D(
docs.blender.org (CC BY-SA 4.0)docs.blender.org/manual/en/latest/render/layers/passes.html
Summary

Source texts are not republished; short quotes are marked, everything else is our own summary and commentary.

3dsınıfı’s take
3dEditor’s assessment

Cryptomatte is a useful option for architectural visualization teams that want more compositing flexibility by isolating objects or materials after rendering. In projects where individual scene elements need to be adjusted, mask outputs can make it easier to work without applying the same operation to the entire image.

For offices and students in Turkey, the most cautious starting point is to test the passes and output connections on a small scene in an existing Blender workflow. The sources don’t specify additional hardware requirements or license costs; however, compatibility should be checked in advance if you plan to use other applications. The stated limitations for volume objects and sidecar files should also be considered when planning a workflow.

Frequently asked questions

What is Blender Cryptomatte used for?

It creates masks for one or more objects or materials in a render. These masks can be used in the Compositor to work with the relevant items separately.

Which pass should I enable for a Cryptomatte mask in Blender?

For object selection, enable Cryptomatte Object in the Passes panel under View Layer. The Cryptomatte Material option is available for material masks.

How does the Cryptomatte node’s Image output work?

For the Image output to work, you need to connect the color render to the Cryptomatte node’s Image input. If you only need a grayscale Matte mask, you can leave the Image input empty.

Comments and the forum are in Turkish.Join the discussion
+

Related news