Preferences

Sofia Emelianova
Sofia Emelianova

Configure the appearance and behavior of DevTools and its panels using Settings. Settings > Preferences. This tab lists both general customization options and panel-specific ones.

To set preferences, open Settings. Settings > Preferences and scroll to one of the sections described next.

The Appearance section in the Preferences tab.

To find out what each setting does, search this page for the setting's name and expand its description.

This reference indicates different settings with the following icons:

  • Checkbox. Checkboxes
  • Drop-down lists Drop-down.
  • Deprecated. Deprecated

To restore default preferences, scroll to the end of the Preferences tab and click Restore defaults and reload.

Appearance

This section lists options that customize DevTools appearance.

Themes Drop-down. sets a color theme for DevTools UI.

Themes: Changing DevTools theme from system preference to dark to light.
  • System preference
  • Light
  • Dark

Panel layout Drop-down. arranges panes in panels.

Affects Elements > Styles and sister tabs, and the Sources > Debugger pane. The auto option makes the layout depend on DevTools width.

Panel layout: Changing the Element's panel layout from horizontal to vertical.
  • horizontal
  • vertical
  • auto

Language Drop-down. sets the locale for DevTools UI.

To apply this setting, reload DevTools.

Language: The Settings panel in Chinese.
  • Browser UI language
  • One of locale options, in this example, Chinese

Checkbox. Enable Ctrl/Cmd + 0-9 shortcut to switch panels lets you open panels using the keyboard.

This video shows how to switch between the tabs using the corresponding keyboard shortcuts.

Checkbox. Disable paused state overlay hides the Paused in debugger Play and step over buttons. overlay in the viewport when code execution is paused.

Checkbox. Show What's New after each update automatically opens the What's New drawer tab after each Chrome update.

The What's New drawer tab.

Sources

This section lists options that customize the Sources panel.

Checkbox. Search in anonymous and content scripts lets you search all loaded JavaScript files, including those in Chrome extensions, using the Search tab.

This video shows how to search for text in an extension source file.

Checkbox. Automatically reveal files in sidebar selects files on the Sources > Page pane when you switch between tabs in the Editor.

This video shows how, with this option enabled, the Sources panel selects files in the navigation tree as you switch between tabs.

Checkbox. Enable JavaScript source maps lets DevTools find sources of generated or minified JavaScript files.

The Sources panel shows a link to the minified file in the status bar.

Checkbox. Enable tab moves focus makes the Tab key. Tab key move focus inside DevTools instead of inserting a Tab character in the Editor.

Requires to reload DevTools.

This video first shows Tab characters inserted with the Tab key. Then when you enable this option and reload DevTools, the Tab key moves focus.

Checkbox. Detect indentation sets indentation to the one in the source file opened in the Editor.

Requires to reload DevTools.

This video first shows the default indentation of eight spaces. Then when you enable this option, it overrides the default indentation to that of the source file.

Checkbox. Autocompletion enables handy suggestions in the Editor.

This video first doesn't show any suggestions. Then when you enable this option, the Editor shows suggestions for command completion.

Checkbox. Auto bracket closing automatically adds a closing bracket or tag when you type an opening one.

This video shows typing opening brackets before and after enabling automatic bracket closing.

Checkbox. Bracket matching underlines and highlights in light red in the Editor a square bracket, curly bracket, or parenthesis without a pair.

A curly bracket without a pair underlined with red.

Checkbox. Code folding lets you fold and unfold code blocks in curly brackets in the Editor.

Requires to reload DevTools.

This video shows how to fold code blocks when you enable this option.

Show whitespace characters Drop-down. displays whitespace characters in the Editor.

Requires to reload DevTools. Options do the following:

  • All denotes all whitespace characters as dots (...). Additionally, the Editor denotes the Tab character as a line ().
  • Trailing highlights whitespace characters at the end of lines in light red.
Show whitespace characters: Options selected: All and Trailing.
  • None
  • All (...)
  • Trailing

Checkbox. Display variable values inline while debugging shows you the variable values next to assignment statements while the execution is paused.

The Debugger paused during function execution displays variable values next to assignment statements.

Checkbox. Focus Sources panel when triggering a breakpoint opens Sources > Editor at the line with the breakpoint that paused execution.

This video first shows the Sources panel out of focus when paused at a breakpoint. Then when you enable this option, DevTools opens the Editor in the Sources panel and shows you the line of code with the breakpoint.

Checkbox. Automatically pretty print minified sources makes those sources readable.

When pretty-printed, the Editor may show a single long code line in multiple lines, preceded by - to indicate that it's a line continuation.

Pretty-printed code in the Sources panel.

Checkbox. Enable CSS source maps lets DevTools find the sources of generated CSS files, for example, .scss, and show them to you.

The Sources panel shows .scss files in the Authored section of the navigation tree. The Styles pane in the Elements panel shows links to .scss sources next to CSS rules.

Checkbox. Allow scrolling past end of file lets you scroll further than the last line in the Editor.

This video shows you how to scroll past the end of file when you enable this option.

Checkbox. Allow DevTools to load resources, such as source maps, from remote file paths. Disabled by default for security reasons.

If left disabled, DevTools logs to the Console messages similar to the following:

A message in the Console informing that loading from a remote file path is prohibited for security reasons.

Default indentation Drop-down. lets you choose the number of spaces the Tab key. Tab key inserts in the Editor.

Default indentation: Disabling overriding options and changing default indentation from two spaces to eight, then to the Tab key.
  • 2 spaces
  • 4 spaces
  • 8 spaces
  • Tab character

This example shows how to set the default indentation to eight spaces first and then to a Tab character.

Elements

This section lists options that customize the Elements panel.

Checkbox. Show user agent shadow DOM displays shadow DOM nodes in the DOM tree.

The Elements panel shows shadow DOM nodes.

Checkbox. Word wrap breaks long lines in the DOM tree and wraps them to the next line.

The Elements panel breaks long lines by words and wraps them onto the next line.

Checkbox. Show HTML comments displays HTML comments in the DOM tree.

The Elements panel shows HTML comments.

Checkbox. Reveal DOM node on hover selects the corresponding node in the DOM tree as you hover over an element in the viewport in Inspect. inspect mode.

This video first shows that DOM nodes aren't selected in the DOM tree. Then when you enable this option, the Elements panel selects the nodes on hover.

Checkbox. Show detailed inspect tooltip displays the tooltip in the viewport in Inspect. inspect mode as you hover over an element.

The detailed tooltip shown in inspect mode.

Checkbox. Show rulers on hover displays the rulers in the viewport as you hover over elements in the DOM tree.

Rulers shown in viewport.

Checkbox. Show CSS documentation tooltip displays a tooltip with a short description when you hover over a property in the Styles pane.

The Learn more link takes you an MDN CSS Reference on the property.

The tooltip with documentation on a CSS property.

Network

This section lists options that customize the Network panel. Most of the options are the same as in the panel's settings.

Checkbox. Preserve log is the same as Preserve log in the Network panel. Saves requests across page loads.

This video first shows the requests log refreshed on page reload, then persisted when you enable this option.

Checkbox. Record network log is the same as Record network log. Record network log in the Network panel. Starts or stops recording requests in the network log.

The Record network log button in the Network panel.

Checkbox. Enable network request blocking blocks requests that match patterns in the Network request blocking drawer.

This video first shows that the requests aren't blocked. Then, after you enable this option, a pattern in the Network request blocking drawer blocks them.

Checkbox. Disable cache (while DevTools is open) is the same as Disable cache in the Network panel. Disables browser cache.

The Disable Cache checkbox.

Checkbox. Color-code resource types highlights requests in different colors depending on their type in the Waterfall column of the network log.

The Waterfall column on the Network tab without and with color-coding.

Checkbox. Group network log by frame is the same as Group by frames in the Network panel. This option groups requests initiated by inline frames.

The network request log with requests grouped by inline frames.

Checkbox. Force ad blocking on this site blocks detected ads on the page while DevTools is open.

An ad-related network request shown in the Network panel with the Blocked Requests filter enabled.

Performance

This section lists options that customize the Performance panel.

Flamechart mouse wheel action Drop-down. assigns scroll or zoom action to your mouse wheel when you navigate the flame chart.

Flame chart mouse wheel action: Changing mouse wheel action from scrolls to zoom for the flame chart.
  • Scroll
  • Zoom

This example shows both scroll and zoom mouse wheel actions on a flame chart in the Performance panel.

Console

This section lists options that customize the Console. Most of the options are the same as in Console Settings.

Similar options in Console and in Settings.

Checkbox. Hide network messages hides network messages in the Console.

This video shows how to hide network messages with this option both in Settings. Settings and in Console Settings.

Checkbox. Selected context only makes the Console show messages only for the selected context: top, iframe, worker, or extension.

This video shows how to enable this option both in Settings. Settings and in Console > Settings and select the context in the Console.

Checkbox. Log XMLHttpRequests makes the Console log XHR and fetch requests.

This video shows how to enable this option both in Settings. Settings and Console > Settings and log the XHR finished loading messages to the Console.

Checkbox. Show timestamps makes the Console show timestamps next to messages.

Messages with timestamps listed in the Console.

Checkbox. Autocomplete from history makes the Console suggest commands you ran earlier as you type.

You can find the same option in Console > Settings.

Autocomplete drop-down with a command option from Console history.

Checkbox. Accept autocomplete suggestion on Enter makes the Console accept the selected suggestion from the autocomplete drop-down when you press Enter.

This video shows what happens when you press Enter before and after enabling this option.

Checkbox. Group similar messages in console makes the Console group similar messages together.

You can find the same option in Console > Settings.

Similar messages in the Console grouped together.

Checkbox. Show CORS errors in console makes the Console show the CORS errors it logged.

You can find the same option in Console > Settings.

Console shows CORS errors.

Checkbox. Eager evaluation makes the Console show a preview of an output as you type a command.

You can find the same option in Console > Settings.

This video shows various output previews.

Checkbox. Treat code evaluation as user action turns any command you run in the Console into user interaction.

In other words, it sets navigator.userActivation.isActive to true upon evaluation. You can find the same option in Console > Settings.

This video shows the evaluation result of navigator.userActivation.isActive before and after enabling this option.

Checkbox. Automatically expand console.trace() messages makes the Console display expanded console.trace() messages when it logs them.

An expanded console.trace() message in the Console.

Checkbox. Preserve log upon navigation makes the Console log a Navigated to message upon every navigation and save logs across all pages.

You can find the same option in Console > Settings.

The Console shows 'Navigated to' messages and saves logs across different pages.

Extension

This section lists options that customize link handling for Chrome DevTools extensions.

Link handling: Choosing an option to open links with.
  • Auto. Opens files in the Sources panel by default.
  • Arbitrary option that can be added by a DevTools extension.

Persistence

This section lists options that control how DevTools saves the changes you make.

Checkbox. Enable local overrides makes DevTools persist changes you make to sources across page loads.

For more information, see Local Overrides.

Debugger

This section lists options that control the Debugger behavior.

Checkbox. Disable JavaScript lets you see how your web page looks and behaves when JavaScript is disabled.

Reload the page to see if and how the page depends on JavaScript while loading.

When JavaScript is disabled, Chrome shows the corresponding Disabled JavaScript. icon in the address bar and DevTools shows a warning Warning. icon next to Sources.

An icon in the address bar and a warning icon next to Sources in DevTools.

Checkbox. Disable async stack traces hides the "full story" of the async operation in the Call Stack.

By default, the Debugger tries to trace async operations if the framework you're using supports such tracing.

The async operation in the Call Stack.

For more information, see View async stack traces.

Global

This section lists options that have global effects in DevTools.

This video first shows how to click a link and open a new tab *without* DevTools. Then when you enable this option, a new tab opens *with* DevTools.

Checkbox. Search as you type makes DevTools "jump" to the first search result as you type your search query. If disabled, DevTools takes you to the result only when you press Enter.

This video first shows how DevTools "jumps" as you type a search query. Then when you enable this option, DevTools takes you to the first result when you press Enter.

Sync

This section lets you set up the synchronization of settings between devices.

Checkbox. Enable settings sync lets you sync DevTools settings across multiple devices.

To use this setting, first enable Chrome Sync. For more information, see Sync settings.