Enable collision detection for tiles

To enable collision detection for tilesA simple class that allows a sprite to be rendered on a Tilemap. More info
See in Glossary, add a Tilemap Collider 2D component to the tilemap.

The Tilemap Collider 2D component automatically generates collider shapes for each tile in the tilemap, so that GameObjects with a Collider2D component collide with the tiles.

You can choose which tiles to enable collision for.

Add a Tilemap Collider 2D component

To add the component to a tilemap, follow these steps:

1. Select an existing tilemap GameObject in your project, or create a tilemap.
2. In the Inspector window, select Add Component.
3. Search for and add the Tilemap Collider 2D component from the list.

The Scene view displays the collider shapes as green outlines over the tilemap.

To make another GameObject collide with the tiles, refer to Collider 2D.

Disable collisions for a tile

Follow these steps:

1. In the Project window, select a tile asset.
2. Set Collider Type to None.

Create a custom collider shape

To change the shape that a tile uses to register a collision, use the Custom Physics Outline window in the Sprite Editor.

1. In the Project window, select a tile asset.
2. Set the Collider Type to Sprite.
3. Select Sprite Editor.
4. In the Sprite Editor window, in the dropdown at the top-left, select Custom Physics Outline.

For more information about editing the shape, refer to Create collision shapes for a sprite.

Reduce the number of collider shapes

To improve the performance of a tilemap with many collider shapes, add a Composite Collider 2D component. Unity merges the collider shapes of neighboring tiles together, which reduces how much Unity needs to calculate during a physics update.

Follow these steps:

1. Select a tilemap with a Tilemap Collider 2D component.
2. In the Inspector window, select Add Component.
3. Search for and add the Composite Collider 2D component from the list.

For more information, refer to Composite Collider 2D component reference.

To further configure performance and collider behavior, use the TilemapCollider2D API.

Update collider shapes manually via API

By default, when you add or remove tiles, the Tilemap Collider 2D updates shapes during LateUpdate and batches multiple changes together for performance. To force immediate updates, follow these steps:

1. Call Tilemaps.TilemapCollider2D.ProcessTilemapChanges to process changes immediately.
2. Check Tilemaps.TilemapCollider2D-hasTilemapChanges to determine if processing is required.

For more information, refer to the TilemapCollider2D API.

Additional resources

• Set up tilemap collision (Unity Learn)
• Tile asset reference
• Tilemap Collider 2D component reference
• Composite Collider 2D component reference