Version: 2023.1
Language : English
Grid component reference
Tile asset reference

Tilemap Renderer component reference

When you create a tilemapA GameObject that allows you to quickly create 2D levels using tiles and a grid overlay. More info
See in Glossary
, Unity automatically attaches the Tilemap Renderer component to the tilemap GameObjectThe fundamental object in Unity scenes, which can represent characters, props, scenery, cameras, waypoints, and more. A GameObject’s functionality is defined by the Components attached to it. More info
See in Glossary
you created. You can determine how Unity renders tiles set on the tilemap by adjusting the following property settings of the Tilemap Renderer component.

Tilemap Renderer component property settings.
Tilemap Renderer component property settings.
Property Description
Sort Order Select the direction that Unity sorts the tiles on the selected tilemap from.
Mode Select the rendering mode of the renderer.
Chunk Select this mode to have the renderer group tiles by their location and the textures used by their sprites, and then batch them together for rendering. Groups with the same textures can be dynamically batched together even if they’re out of locational sequence of each other (based on the direction selected for the renderer’s Sort Order).

Select this mode for the best rendering performance with tilemaps.

Note: This mode isn’t compatible with the Scriptable Render Pipeline Batcher.
Individual Select this mode to have the renderer render each tile individually, taking into account their location and position in the Sort Order. This mode enables the spritesA 2D graphic objects. If you are used to working in 3D, Sprites are essentially just standard textures but there are special techniques for combining and managing sprite textures for efficiency and convenience during development. More info
See in Glossary
on the tiles to interact with other renderers in the sceneA Scene contains the environments and menus of your game. Think of each unique Scene file as a unique level. In each Scene, you place your environments, obstacles, and decorations, essentially designing and building your game in pieces. More info
See in Glossary
or with a Custom Sorting Axis.
SRP Batch Select this mode to make the Tilemap Renderer component compatible with the Scriptable Render Pipeline Batcher, once the compatibility requirements are also met. Note: This mode is only supported in the Universal Render Pipeline version 15 onwards.

This rendering mode groups tiles by their location and the textures used by their sprites, and then batch them together for rendering. Groups with the same textures will be dynamically batched together only if they’re in locational sequence of each other (based on the direction selected for the renderer’s Sort Order).
Detect Chunk Culling Bounds Select the way the renderer detects the bounds used for the culling of tilemap chunks. These bounds expand the boundary of tilemap chunks to ensure that oversize sprites aren’t clipped during culling.
Auto The Renderer automatically inspects the Sprites used by the Tiles to determine the expanded culling bounds to use.
Manual The values used to extend the bounds for culling of the tilemap chunks are manually set instead of with the Editor’s automatic detection.
Chunk Culling Bounds This property is visible only when Detect Chunk Culling Bounds is set to Manual
XYZ Enter the values (in Unity units) to extend the culling bounds by.
Mask Interaction Set how the Tilemap Renderer behaves when it interacts with a Sprite MaskA texture which defines which areas of an underlying image to reveal or hide. More info
See in Glossary
.
None Select this option to have the Tilemap Renderer not interact with any Sprite Mask in the scene. This is the default option.
Visible Inside Mask Select this option to have the Tilemap Renderer only render areas of the tilemap that the Sprite Mask overlays.
Visible Outside Mask Select this option to have the Tilemap Renderer render the entire tilemap but subtract the areas that the Sprite Mask overlays.
Material Select the material used to render the sprite textures.

Additional Settings

Properties in the Additional Settings section.
Properties in the Additional Settings section.
Property Description
Sorting Layer Select an existing Sorting Layer from the Sorting Layer dropdown or create a new Sorting Layer for this tilemap.
Order in Layer Set the render priority of the tilemap within its Sorting Layer. Unity renders lower numbered layers first, and higher numbered layers overlap those below.

TilemapRenderer

Grid component reference
Tile asset reference