Version: 2021.3
Language : English
The Background Tasks window
Additional windows

Console Window

The Console Window displays errors, warnings, and other messages the Editor generates. These errors and warnings help you find issues in your project, such as script compilation errors. They also alert you to actions the Editor has taken automatically, such as replacing missing meta files, which could cause an issue somewhere else in your project.

To help you debug your project, use the Debug class to print your own messages to the Console. For example, you can print the value of a variable at certain points in your script to see how they change.

This page covers the options you can use when you work with the Console window, and how you can filter your messages by searching for specific keywords.

Console window interface

To open the Console, from Unity’s main menu go to Window > General > Console.

A. The Console 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
has options for controlling how to display messages, and for searching and filtering messages.

B. The Console window menu has options for opening Log files, controlling how much of each message is visible in the list, and setting stack trace options.

C. The Console list displays an entry for each logged message. Select a message to display its entire text in the detail area. You can choose how many lines of each message to display here. See Adjusting the line count, below.

D. The detail area displays the full text of the selected message. If you enable stack trace, the detail area displays references to specific lines in code files as clickable links.

Console toolbar options

The toolbar of the Console window has options for controlling how to display messages, and for searching and filtering messages.

Option: Function:
Clear Removes any messages generated from your code but retains compiler errors.

Opens a dropdown menu with clearing options.
Clear On Play Clears the Console automatically whenever you enter Play mode.
Clear on Build Clears the Console when you build the Project.
Clear on Recompile Clears the console when you recompile the Project.
Collapse Displays only the first instance of recurring error messages.

This is useful for run-time errors, such as null references, that are sometimes generated on each frame update.
Error Pause Pauses playback whenever you call Debug.LogError from a script.

Use this to freeze playback at a specific point in the execution and inspect the Scene. This option doesn’t pause playback when you call Debug.Log from a script.
[Attach-to-Player] Opens a drop-down menu with options for connecting to development builds that are running on remote devices, and displaying their Player logs in the Console.

This option is labeled with the name of the target development build (which is the build of the log that’s displayed in the Console window). If the Console isn’t connected to a remote build, it’s labeled Editor to show that the log displayed in the Console window is from the local Unity Editor.
Player Logging If the Console is connected to a remote development build, this enables Player logging for the build.

Disabling this option suspends logging, but the Console remains connected to the target build.

Disabling this option also hides the rest of the options in this drop-down menu.

Select any build listed below Player Logging to display its log in the Console window.
Editor If the Console is connected to a remote development buildA development build includes debug symbols and enables the Profiler. More info
See in Glossary
, select this option to display the log from the local Unity Player instead of the log from the remote build.
<Enter IP> Opens the Enter Player IP dialog, where you can specify the IP address of a development build on a remote device.

To connect to the build, select Connect in the dialog, and add it to the list of development builds at the bottom of the drop-down menu.
[DEVELOPMENT BUILDS] Lists the available development builds. This includes autodetected builds, and those that you add using the Enter IP option.

Searching and filtering Console output

You can search Console messages for specific keywords from the Console search bar. As you type a search term, the Console filters messages to display only those that contain matching text. The Console highlights only the first match in the message text, and only if it’s in the visible part of the message (see Adjusting the Line Count below).

Searching for the term “name” highlights the first match in each message
Searching for the term “name” highlights the first match in each message

You can search for anything that appears in any Console message, including numerals and special characters. For example, you can search for the time the console logged a message.

The search looks for exact matches of whatever you type in the search bar. You can’t search for two different terms at once, or use common search engine operators.

You can also filter Console messages by type. Click the buttons beside the search bar to toggle:

Button Function


Messages switch
Displays the number of messages in the Console. Click to display or hide messages.


Warnings switch
Displays the number of warnings in the Console. Click to display or hide warnings.


Errors switch
Displays the number of errors in the Console. Click to display or hide errors.

Adjusting the line count

Each Console entry can be up to 10 lines long.

To control how many lines of each entry are visible in the list, click the Console menu button, and select Log Entry > [X] Lines from the menu, where [X] is the number of lines to display for each entry.

Log entry line count
Log entry line count

A larger line count displays more of the text of each entry, but reduces the number of entries visible at any given time. The line count doesn’t affect the Console search function, which always searches the full message text. If the matching text is on a hidden line, the search returns the message in the results, but doesn’t expand it to reveal or highlight the matching text. You can see the full message text in the detail area, but the matching text isn’t highlighted there.

Stack trace logging

Unity Console messages and log files can include detailed stack trace information. You can control the amount of stack trace information using the stack trace logging settings.

Opening Log files from the Console

Everything Unity or your code write to the Console Window is also written to a Log File. You can open Log files from the Console window menu. Select Open Player LogThe .log file created by a Standalone Player that contains a record of events, such as script execution times, the compiler version, and AssetImport time. Log files can help diagnose problems. More info
See in Glossary
or Open Editor Log.

The Background Tasks window
Additional windows
Copyright © 2023 Unity Technologies
优美缔软件(上海)有限公司 版权所有
"Unity"、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属机构在美国及其他地区的商标或注册商标。其他名称或品牌是其各自所有者的商标。
公安部备案号:
31010902002961