You can use different features and tools in the Tile Palette editor window to create and edit tile palettes and the way you paint on tilemapsA GameObject that allows you to quickly create 2D levels using tiles and a grid overlay. More info
See in Glossary.
To open the Tile Palette window, go to Window > 2D > Tile Palette. If you have created a Tilemap, select it in the Hierarchy window and the Open Tile Palette overlay appears in the Scene view. Select the Open Tile Palette in the overlay to open the Tile Palette window.
Use these tools to paint tiles on a tilemap. Specific instructions on how to use these tools are available on their respective pages.
A: The toolbarA row of buttons and basic controls at the top of the Unity Editor that allows you to interact with the Editor in various ways (e.g. scaling, translation). More info
See in Glossary displaying the palette tools available.
B: The Active Target dropdown menu and overlay toggle buttons.
C: The main window where you view and edit the active tile palette’s contents.
D: The Brush InspectorA Unity window that displays information about the currently selected GameObject, asset or project settings, allowing you to inspect and edit the values. More info
See in Glossary window.
Select a tool from the toolbar to when painting on the tilemap for additional properties and effects. You can also use these tools to edit the active tile palette itself by unlocking the tile palette for editing. Refer to each tool’s documentation for more information about their specific uses and features.
Control | Description | Shortcut key |
---|---|---|
Select tool |
Use the Select tool to select a tile on the Active Tilemap or click and drag over multiple tiles to select more at once. | S |
Move tool |
Use the Move tool to move a tile selection made with the Select tool. Note: The Move tool can’t select tiles itself. | M |
Paint tool |
Use the Paint tool to select a tile on the tile palette, or click and drag over multiple tiles to select more at once. Then click on the tilemap in the scene to paint with the selected tiles. | B |
Box Fill tool |
Use the Box Fill tool to select a tile on the tile palette, or click and drag over multiple tiles to select more at once. Then click and drag the Box Fill tool over the tilemap in the scene to draw a rectangular shape, which is then filled with the selected tile(s) when you release the tool. | U |
Pick Tool |
Use the Pick tool to pick a tile from the tilemap or tile palette, or click and drag over multiple tiles to select more at once. The active tool switches to the Paint tool once you make the selection and you can paint on the tilemap with the selected tile(s). | I |
Eraser tool |
Use the Eraser tool to erase tiles by selecting them with this tool. To erase many tiles at once, first click and drag the Eraser tool to a larger size in the tile palette, then paint over tiles you want to erase on the tilemap. | D |
Flood Fill tool |
Use the Flood Fill tool to fill a contiguous area of empty cells or identical tiles with the selected tile. Select the tile to use as the fill by selecting it from the tile palette. This tool can’t be used with more than one tile. | G |
Rotates the active brush counterclockwise. | [ | |
Rotates the active brush clockwise. | ] | |
Flips the active brush along the x-axis. | Shift+[ | |
Flips the active brush along the y-axis. | Shift+] |
Control | Description |
---|---|
Active Target |
This displays the current active Tilemap the editor is targeting, and lists the name of available tilemaps in this project. Select from the list of tilemaps to make that tilemap the Active Target. |
Brush picks overlay toggle |
Select this to display or hide the tile palette’s Brush Picks overlay in the Scene view. |
Tile Palette clipboard overlay toggle |
Select this to display or hide the Tile Palette Clipboard overlay in Scene view. |
The following control options are available in the Active Target dropdown and when you select Create New Tilemap.
Control | Description |
---|---|
Visibility toggle |
Select this to reveal or hide the target tilemap in the Scene view. |
Ping button |
Select this to highlight the target tilemap in the Hierarchy window to help you identify the target tilemap. |
Create New Tilemap | Select the type of tilemap you want to create and name it at creation. If you don’t enter a name, Unity names the newly created tilemap as “Tilemap” by default and appends a number to it if there are duplicate tilemaps with the same name. |
From Tile Palette | Select this to create a tilemap based on the tile dimensions of your active tile palette. This changes the tile dimensions of the parent Grid of the child tilemap to match the tile palette. This ensures that the tiles of the tile palette fits the newly created tilemap. |
Rectangular Tilemap | Select this to create a default rectangular tilemap. |
Hexagonal Point Top Tilemap | Select this to create Hexagonal Point Top tilemap. |
Hexagonal Flat Top Tilemap | Select this to create Hexagonal Flat Top tilemap. |
Isometric Tilemap | Select this to create an Isometric tilemap. |
Isometric Z As Y Tilemap | Select this to create an Isometric Z As Y tilemap. |
This overlay is a compact version of the Tile Palette editor’s main editor window 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 view. It mirrors the main editor window’s tile palette and toggles. Changing the active tile palette in one window also changes it in the other window. Use this overlay to keep a copy of the tile palette in the Scene view even when you minimize the Tile Palette editor. Note: Closing the Tile Palette editor also closes this overlay.
This section of the window displays the active tile palette, and is where you edit the contents of the tile palette.
Control | Description |
---|---|
Active Palette |
This displays the current active tile palette and lists the name of available tile palettes in this project. Select from the list of tile palettes to make that tile palette the Active Palette. |
Create New Tile Palette | Select this to create a new tile palette. Unity names the created tile palette “New Palette” default and appends a number to it if there are duplicate tile palettes with the same name. |
Edit Tile Palette toggle |
Select this to unlock or lock the Active Palette for editing with the Tile Palette toolbar. |
Grid visibility toggle |
Select this to reveal or hide the grid lines in the Tile Palette editor window. This toggle is switched on by default. |
Gizmo visibility toggle |
Select this to reveal or hide gizmos in the Tile Palette editor window. |
You can find the Brush Inspector window at the bottom of the Tile Palette editor window, and you can use it to change the current active brush and its properties. You can minimize or expand the Brush Inspector by clicking the Brush Inspector visibility toggle, or drag the bottom toolbar upwards to expand it the window.
Use the dropdown menu to change the active brush from the Default Brush to one of the 2D Tilemap Extras package’s Scriptable Brushes.
Control | Description |
---|---|
Default Brush | The default brush with no additional properties. |
GameObject Brush | Select this brush to instance, place and manipulate 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 onto the Scene view. |
Group Brush | Select this brush to pick tiles which are grouped together according to their position and set properties. |
Random Brush | Select this brush to place random tiles onto a tilemap by selecting from defined Tile Sets while painting onto the tilemap. |
Line Brush | Select this brush to draw a line of tiles onto a tilemap. |
Refer to the Scriptable Brushes’ respective documentation for more information on their specific properties and usage.
Property | Description |
---|---|
Script | Displays the assigned script Asset that provides a fixed set of APIs for painting on tilemaps. The default is the GridBrush. Users may use or create their own Scriptable Brushes which become available from the dropdown menu. The Script property updates to reflect the current active brush. |
Flood Fill Contiguous Only | Enable this property to have the Flood Fill tool only affect tiles on a tilemap which are both the same as the targeted tile and are contiguous to each other from the targeted position. When disabled, Flood Fill will change all tiles which are the same as the targeted tile on a tilemap regardless of their position. This only affects the Default Brush. |
Lock Z Position | Enable this property to change the z-position of the active brush. Disable to prevent any changes to the current z-position of the active brush. |
Z Position | Only available when Lock Z Position is disabled. Enter the desired z-axis value (only whole numbers) for this brush when painting tiles, which also adjusts the relative heights of tiles on a Z as Y Isometric Tilemap . Refer to Adjusting the Tile height in the Palette for more information. |
Reset | Select to reset the z-position value back to zero. |
The Tilemap Focus overlay appears in the Scene view while the Tile Palette editor window is opened. Use the Tilemap Focus overlay to focus on a specific tilemap or grid by fading out other GameObjects in the Scene view. This helps to identify specific tilemaps if you are working with many tilemaps to avoid confusion and clutter. The Tilemap Focus overlay only affects the Tile Palette editor’s Active Target tilemap.
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
What kind of problem would you like to report?
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
Provide more information
You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:
You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:
You've told us there is information missing from this page. Please tell us more about what's missing:
You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:
You've told us this page has a problem. Please tell us more about what's wrong:
Thank you for helping to make the Unity documentation better!
Your feedback has been submitted as a ticket for our documentation team to review.
We are not able to reply to every ticket submitted.
When you visit any website, it may store or retrieve information on your browser, mostly in the form of cookies. This information might be about you, your preferences or your device and is mostly used to make the site work as you expect it to. The information does not usually directly identify you, but it can give you a more personalized web experience. Because we respect your right to privacy, you can choose not to allow some types of cookies. Click on the different category headings to find out more and change our default settings. However, blocking some types of cookies may impact your experience of the site and the services we are able to offer.
More information
These cookies enable the website to provide enhanced functionality and personalisation. They may be set by us or by third party providers whose services we have added to our pages. If you do not allow these cookies then some or all of these services may not function properly.
These cookies allow us to count visits and traffic sources so we can measure and improve the performance of our site. They help us to know which pages are the most and least popular and see how visitors move around the site. All information these cookies collect is aggregated and therefore anonymous. If you do not allow these cookies we will not know when you have visited our site, and will not be able to monitor its performance.
These cookies may be set through our site by our advertising partners. They may be used by those companies to build a profile of your interests and show you relevant adverts on other sites. They do not store directly personal information, but are based on uniquely identifying your browser and internet device. If you do not allow these cookies, you will experience less targeted advertising. Some 3rd party video providers do not allow video views without targeting cookies. If you are experiencing difficulty viewing a video, you will need to set your cookie preferences for targeting to yes if you wish to view videos from these providers. Unity does not control this.
These cookies are necessary for the website to function and cannot be switched off in our systems. They are usually only set in response to actions made by you which amount to a request for services, such as setting your privacy preferences, logging in or filling in forms. You can set your browser to block or alert you about these cookies, but some parts of the site will not then work. These cookies do not store any personally identifiable information.