ProfessionalCommunity Edition

Inspector and message editor settings

  • Last updated: January 29, 2024

  • Read time: 4 Minutes

The Inspector and message editor settings page is located under User interface in the Settings dialog.

This page contains settings for the Inspector:

It also contains settings for the message editor:

The Inspector and message editor settings are user settings. They apply to all installations of Burp on your machine.

Inspector widgets

These settings enable you to adjust how widgets are displayed in the Inspector panel. For each widget, you can:

  • Show - Enable this setting to show the widget in the Inspector panel.
  • Open by default - Enable this setting to expand the widget in the Inspector panel by default.
  • Wrap text - Enable this setting to wrap the text inside the widget cells.

To reorder the list of widgets, use the Up and Down buttons.

Default Inspector panel layout

These settings enable you to set the default layout for the Inspector panel.

You can set the panel's default position as Left or Right.

You can set the panel's display mode:

  • Auto-expand - By default, the Inspector expands and collapses with the available screen space.
  • Always collapsed - Enable this setting to keep the Inspector collapsed.

Related pages

Inspector.

Message editor request and response views

The Message editor request views and Message editor response views settings enable you to adjust the views of the message content in the message editor. Each view is displayed in an individual tab, and provides the same functionality as the widgets in the Inspector panel.

For each view option, you can:

  • Show - Enable this setting to display the view in a message editor tab. By default the Pretty, Raw, Hex, and Render view tabs are displayed.
  • Wrap text - Enable this setting to wrap the text inside the message editor.

To reorder the list of views, use the Up and Down buttons.

Note

In read-only contexts, such as the proxy history, the message editor only displays the selected views if the message contains appropriate content. For example, you won't see the Cookies tab unless the request contains one or more cookies.

In editable contexts, such as in Burp Repeater, the message editor displays all views. This gives you the option to add items even if none were included in the original request.

HTTP message display

These settings enable you to control how HTTP messages are displayed within the HTTP message editor. You can configure the following:

  • Font - Select the font style and size you want to use. You can also enable font smoothing.
  • Highlight request syntax - Enable this setting to color-code request syntax. This includes any JavaScript, JSON, and CSS content.
  • Highlight response syntax - Enable this setting to color-code response syntax. This includes any JavaScript, JSON, and CSS content.
  • Pretty print by default - Enable this setting to automatically prettify data, markup, and code. Burp adds standardized line breaks and indentation to unformatted text. Pretty printing is supported for JSON, XML, HTML, CSS, and JavaScript.

Related pages

Character sets

These settings control how Burp handles character sets when it displays raw HTTP messages. The available settings are:

  • Recognize automatically based on message headers - By default, Burp automatically recognizes the character set of each message, based on the message headers. This enables you to work concurrently on messages that use different character sets.
  • Use the platform default - Select this option to use the default UTF-8 character set for all messages.
  • Display as raw bytes - Select this option to display the messages as raw bytes (using ASCII encoding), without processing any extended characters.
  • Use a specific character set - Choose a character set from the drop-down list. This character set is used with all messages.

HTTP headers are always displayed in raw form. The charset encoding options only apply to the message body.

Note

Some of the glyphs required for certain character sets are not supported by all fonts. If you need to use an extended or unusual character set, you should first try a system font such as Courier New or Dialog.

HTML rendering

The Render view within the HTTP message editor displays HTML content approximately as it would appear in your browser. This setting controls whether Burp can make additional HTTP requests to fully render HTML content (for example, to display embedded images).

Select this setting to increase the quality of Burp's HTML rendering at the expense of some speed. This setting increases the overall number of requests that Burp makes to the target application.

Related pages

Burp Suite message editor.

The HTTP Message search settings control the search bar at the bottom of the message editor window. By default, none of these settings are enabled:

  • Case sensitive - Choose whether the search is case sensitive.
  • Regex - Specify whether the search term is a regular expression or a literal string.
  • Auto-scroll to match when text changes - Specify whether the text editor automatically scrolls to the first highlighted match when new text is displayed. This is useful if you want to step through items in the Proxy history, to look for a particular expression in the responses.

Was this article helpful?