Version: Unity 6.0 (6000.0)
Language : English
Gizmos and handles
Gizmos menu reference

Gizmos introduction

Gizmos are graphics associated with GameObjects 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
. Some gizmosA graphic overlay associated with a GameObject in a Scene, and displayed in the Scene View. Built-in scene tools such as the move tool are Gizmos, and you can create custom Gizmos using textures or scripting. Some Gizmos are only drawn when the GameObject is selected, while other Gizmos are drawn by the Editor regardless of which GameObjects are selected. More info
See in Glossary
are only drawn when the 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
is selected, while other gizmos are drawn by the Unity Editor regardless of which GameObjects are selected. They are usually wireframes, drawn with code rather than bitmap graphics, and can be interactive.

The CameraA component which creates an image of a particular viewpoint in your scene. The output is either drawn to the screen or captured as a texture. More info
See in Glossary
gizmo and Light direction gizmo are both examples of built-in gizmos. You can also create your own Gizmos using script. Refer to Introduction to the camera view for more information about the camera.

Some gizmos are passive graphical overlays, shown for reference (such as the Light direction gizmo, which shows the direction of the light). Other gizmos are interactive, such as the audio sourceA component which plays back an Audio Clip in the scene to an audio listener or through an audio mixer. More info
See in Glossary
spherical range gizmo, which you can click and drag to adjust the maximum range of the audio source.

The Move, Scale, Rotate and Transform tools are also interactive gizmos. Refer to Positioning GameObjects to learn more about these tools.

The camera gizmo and a light gizmo. These gizmos are only visible when they are selected.
The camera gizmo and a light gizmo. These gizmos are only visible when they are selected.

Refer to the OnDrawGizmos method for further information about implementing custom Gizmos in your 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
.

Icons

You can display icons in the Game view or Scene viewAn interactive view into the world you are creating. You use the Scene View to select and position scenery, characters, cameras, lights, and all other types of Game Object. More info
See in Glossary
as flat, billboard-style overlays. These help indicate a GameObject’s position while you work on your game. The Camera icon and Light icon are examples of built-in icons. You can also assign custom icons to GameObjects or individual scripts. For more information, refer to Assigning Icons.

The built-in icons for a Camera and a Light
The built-in icons for a Camera and a Light
Left: icons in 3D mode. Right: icons in 2D mode.
Left: icons in 3D mode. Right: icons in 2D mode.

Selection wireframes

Unity provides visual feedback when you select GameObjects in the Scene view through selection outlines and wireframes. These visual indicators help you identify selected objects and understand their hierarchy relationships at a glance.

Selection Outline

When Selection Outline is enabled, an outline appears around selected GameObjects and their child GameObjects. By default, Unity outlines selected GameObjects in orange, and child GameObjects in blue. You can change these colors in the Unity Preferences window.

Selecting a GameObject (the far left box) outlines it in orange, and outlines its child GameObjects (the middle and right boxes) in blue.
Selecting a GameObject (the far left box) outlines it in orange, and outlines its child GameObjects (the middle and right boxes) in blue.

When you select a GameObject, Unity outlines all its child GameObjects (and their child GameObjects), but doesn’t outline parent GameObjects (or their parent GameObjects).

Selecting the middle box highlights it in orange, and highlights its child GameObject (the far right box) in blue, but doesnt highlight its parent GameObject (the far left box).
Selecting the middle box highlights it in orange, and highlights its child GameObject (the far right box) in blue, but doesn’t highlight its parent GameObject (the far left box).

If selected GameObjects extend beyond the edges of the Scene view, the selection outline runs along the edge of the window:

The selection outline along the edge of the window, when the GameObject you selected extends beyond the Scene view
The selection outline along the edge of the window, when the GameObject you selected extends beyond the Scene view

Selection Wire

When Selection Wire is enabled, then when you select a GameObject in the Scene view or Hierarchy window, the wireframe MeshThe main graphics primitive of Unity. Meshes make up a large part of your 3D worlds. Unity supports triangulated or Quadrangulated polygon meshes. Nurbs, Nurms, Subdiv surfaces must be converted to polygons. More info
See in Glossary
for that GameObject is made visible in the Scene view:

The wireframe visible on a mesh
The wireframe visible on a mesh

Selection colors

You can set custom colors for selection wireframes.

  1. Go to Unity > Settings (macOS) or Edit > Preferences (Windows) to open the Preferences window.
  2. On the colors tab, change one or more of the following colors:
    • Selected Children Outline: outline color for selected GameObjects’ children.
    • Selected Outline: outline color for selected GameObjects.
    • Wireframe Selected: outline color for selected GameObjects’ wireframes.

Built-in components, scripts, and recently changed items

Use the list in the Gizmos menu to control the visibility of icons and gizmos for various components. The list is divided into sections:

The Gizmos menu, displaying items with custom icons and some recently modified items
The Gizmos menu, displaying items with custom icons and some recently modified items

Recently Changed

The Recently Changed section controls the visibility of the icons and gizmos for items that you’ve modified recently. It appears the first time you change one or more items. Unity updates the list after subsequent changes.

Scripts

The Scripts section controls the visibility of the icons and gizmos for scripts that:

This section appears when your Scene contains one or more scripts that meet the above criteria.

Built-in Components

The Built-in Components section controls the visibility of the icons and gizmos for all component types that have an icon or gizmo.

Built-in component types that do not have an icon or gizmo shown in the Scene view (for example, Rigidbody) are not listed here.

Toggling icon visibility

The icon column shows or hides the icons for each component type. Full-color icons are displayed in the main Scene view window, faded icons are not.

The Light icon is faded, indicating that the Editor does not display light icons in the Scene view. The Camera icon is full-color, indicating that the Editor does display camera icons in the Scene view.
The Light icon is faded, indicating that the Editor does not display light icons in the Scene view. The Camera icon is full-color, indicating that the Editor does display camera icons in the Scene view.

To toggle an icon’s visibility in the Scene view, click any icon in the icon column.

Note: If an item in the list has a gizmo but no icon, the icon column for that item is empty.

Changing script icons

Scripts with custom icons show a small drop-down menu arrow in the icon column. To change a custom icon, click the arrow to open the Select Icon menu.

The Select Icon menu for script
The Select Icon menu for script

Toggling gizmo visibility

To control whether the Editor draws gizmo graphics for a particular component type (for example, a Collider’s wireframe gizmo or a Camera’s view frustum gizmo) or script, use the checkboxes in the Gizmo column.

  • When a checkbox is checked, the Editor draws gizmos for that component type.

  • When a checkbox is cleared, the Editor does not draw gizmos for that component type.

Note: If an item in the list has an icon but no gizmo, the Gizmo column for that item is empty.

To toggle gizmo visibility for an entire section (all Built-in Components, all Scripts, and so on), use the checkboxes next to the section names.

The Built-in Components checkbox toggles gizmo visibility for every type of component listed in that section

When the checkbox is toggled on, gizmo visibility is toggled on for one or more item types in the section.

Additional resources

Gizmos and handles
Gizmos menu reference