Version: 2020.3
Sprite Shape Renderer
Grid
How do you use documentation throughout your workflow? Share your experience with us by taking this survey.

Tilemap

The Tilemap component is a system which stores and handles Tile Assets for creating 2D levels. It transfers the required information from the Tiles placed on it to other related components such as the Tilemap Renderer and the Tilemap Collider 2D

Download the 2D Tilemap Editor package via the Package Manager, as it is not included in the Unity Editor default installation.

When you create a Tilemap, the Grid component is automatically parented to the Tilemap and acts as a guide when you lay out Tiles onto the Tilemap.

To create, modify, and pick the Tiles for painting onto a Tilemap, use the Tile Palette (menu: Window > 2D > Tile Palette) and its tools. Refer to the documentation on Tile Palette and Painting Tilemaps for more information.

Tilemap property window
Tilemap property window
Property Function
Animation Frame Rate The rate at which Unity plays Tile animations. Increasing or decreasing this changes the speed by the equivalent factor (for example, if you set this to 2, Unity plays Tile animations at double the speed).
Color Select a color to apply as a tint to the Tiles on this Tilemap. Set to white (default color) to have Unity render the Tiles without tint.
Tile Anchor Enter the amount (in cells) along the XYZ axes to offset Tile anchor positions on the Tilemap.
Orientation Select the orientation of Tiles on the Tilemap. Use this if you need to orientate Tiles along a specific plane.
    XY Unity orients Tiles along the XY plane.
    XZ Unity orients Tiles along the XZ plane.
    YX Unity orients Tiles along the YX plane.
    YZ Unity orients Tiles along the YZ plane.
    ZX Unity orients Tiles along the ZX plane.
    ZY Unity orients Tiles along the ZY plane.
    Custom Select this option to enable the custom orientation settings below.
Position Set the position offset of the custom orientation. This option is disabled by default and is enabled when the Tilemap’s Orientation is set to Custom.
Rotation Set the rotation of the custom orientation. This option is disabled by default and is enabled when the Tilemap’s Orientation is set to Custom.
Scale Set the scale of the custom orientation. This option is disabled by default and is enabled when the Tilemap’s Orientation is set to Custom.

2D extras in GitHub

You can download examples of scripted TilesA simple class that allows a sprite to be rendered on a Tilemap. More info
See in Glossary
and Brushes from the 2D Extra GitHub repository. Example projects with these scripted GameObjectsThe 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
are available in the 2D Techdemos Github repository. For descriptions of the different scriptsA piece of code that allows you to create your own Components, trigger game events, modify Component properties over time and respond to user input in any way you like. More info
See in Glossary
and usage information, refer to the README.md for each repository.


  • Page content and screenshots updated for 2020.1 NewIn20201
  • 2D Tilemap Editor is no longer included with the Editor installation and must be downloaded from Package Manager. 2019.2 NewIn20192
  • Isometric Tilemap functionality added in Unity 2018.3 NewIn20183
  • Hexagonal Tilemap functionality added in Unity 2018.2 NewIn20182
  • Tilemaps added in 2017.2 NewIn20172
Sprite Shape Renderer
Grid