Get involved in the Burp challenge for opportunities to test your skills and win swag  –   Challenge me

PROFESSIONALCOMMUNITY

Inspector and message editor settings

  • Last updated: November 25, 2022

  • Read time: 4 Minutes

The Inspector and Message Editor settings enable you to adjust the display position for the Inspector panel, and control what information is shown. Click Open Inspector settings to display the Inspector settings dialog.

The dialog has two tabs:

  • Inspector - Settings defining which widgets are displayed on the Inspector panel and which side of the screen the panel is displayed on.
  • Message editor - Settings defining which tabs are shown in Message editor requests and responses.

Widgets

The Widgets settings enable you to adjust how widgets are displayed within the Inspector. You can:

  • Select which widgets are shown on the Inspector panel.
  • Select whether each widget is expanded by default.
  • Select whether the text inside the cells of each widget should be wrapped.
  • Re-order the list of widgets using the Up and Down buttons.

Position and display options

The Position & display options settings enable you to set the default layout for the Inspector panel. You can:

  • Set the panel's default position (either left or right).
  • Set the panel's display mode. By default, the Inspector is set to Auto-expand, which expands and collapses the panel depending on the available screen space. To keep the Inspector collapsed, select the Always collapsed radio button.

The settings on the Inspector settings dialog are global - they apply when using the Inspector across all Burp Suite tools.

Related pages

For more information, see the Inspector documentation.

Message editor settings

The Message editor tab enables you to:

  • Edit the views shown in the toolbar for requests in the message editor.
  • Edit the views shown in the toolbar for responses in the message editor.
  • Control whether the text on each of the views should be wrapped.
  • Reorder the lists of views.

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 there were none in the original request.

Related pages

For more information, see the Message editor documentation.

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

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 - The font style and size you want to use. You can also specify whether Burp uses font smoothing.
  • Highlight request syntax - This setting enables syntax colorizing for requests. This includes any JavaScript, JSON, and CSS content.
  • Highlight response syntax - This setting enables syntax colorizing for responses. This includes any JavaScript, JSON, and CSS content.
  • Pretty print by default - This controls whether Burp automatically prettifies data, markup, and code by adding standardized line breaks and indentation to unformatted text. Pretty printing is supported for JSON, XML, HTML, CSS, and JavaScript.

Related pages

The HTTP message display settings are user settings. They apply to all installations of Burp on your machine.

Character sets

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

  • Recognize the character set of each message automatically, based on the message headers. This is the default setting, and enables you to work concurrently on messages that use different character sets.
  • Use the platform default character set for all messages.
  • Display messages as raw bytes (using ASCII encoding), without processing any extended characters.
  • Use a specific character set for all messages. Select the required character set from the list.

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.

The Character sets settings are user settings. They apply to all installations of Burp on your machine.

HTML rendering

The Render view within the HTTP message editor displays HTML content approximately as it would appear in your browser. The Make additional HTTP requests if required to render the page setting controls whether Burp can make any additional HTTP requests that are required 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 also increases the overall number of requests that Burp makes to the target application.

Related pages

For more information, see the Message editor documentation.

The HTML rendering settings are user settings. They apply to all installations of Burp on your machine.

The HTTP Message search settings control the default configuration of the search bar at the bottom of the message editor window. The available settings are:

  • Case sensitive - This setting defines whether searches are case sensitive by default.
  • Regex - This setting defines whether Burp should treat the default search term as a regular expression or a literal string.
  • Auto-scroll to match when text changes - This setting specifies whether the text editor should automatically scroll to the first highlighted match when new text is displayed. This is useful when looking for a particular expression in the responses in the Proxy history, for example. If this option is selected, Burp automatically scrolls to the first search match when you select a new item.

The HTTP Message search settings are user settings. They apply to all installations of Burp on your machine.

Was this article helpful?