> For the complete documentation index, see [llms.txt](https://documentation.hak5.org/payload-studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.hak5.org/payload-studio/customization/editor-settings.md).

# Editor Settings

Settings related to the look and feel of the Editor within PayloadStudio

{% hint style="danger" %}
Some options are limited to <mark style="color:red;">PayloadStudio Pro</mark>. These will be indicated with the <img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2FYnPm8y8V7BbbQiPC4hKg%2Fimage.png?alt=media&amp;token=2ec4567d-0186-4009-ba76-1f36606936e8" alt="Pro" data-size="line">label
{% endhint %}

{% hint style="success" %}
Even though each setting is named to be self explanatory - every setting in PayloadStudio contains an description / explanation tool-tip available **on hover**
{% endhint %}

<figure><img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2FTp9vYGCtIX3ay05kV1OO%2FScreenshot%20from%202023-01-28%2020-39-35.png?alt=media&amp;token=343e33e5-5256-45f6-b8c4-4b154438d616" alt=""><figcaption><p>Setting description tool-tip</p></figcaption></figure>

### `Console Window Size (%)`

Adjust this to change the size of the Console. \
*Value is % it will cover the Main Editor.* \
*Default: 45*

### `Console Font Size (px)`

Change the Console, language editor and breakpoint editor default font size. \
*Value in px.* \
*Default: 20*

### `Main Editor Font Size (px)`

Change the Editor's default font size. \
*Value in px.* \
*Default: 20*

## Editor Customization <img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2FYnPm8y8V7BbbQiPC4hKg%2Fimage.png?alt=media&amp;token=2ec4567d-0186-4009-ba76-1f36606936e8" alt="Pro" data-size="line">

### `Keybindings`

Change keybinding / keyboard shortcut modes\
\
**Options:**

* `Default (ACE)`
* `Vim`
* `Emacs`
* `Sublime`
* `VSCode`

### `Text Wrapping`

Change the editor text wrapping mode

**Options:**

* `Off`
* `View`
* `Margin`
* `40`

<figure><img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2FYDjXvBwdV2FLWS9zXllC%2FScreencast%20from%2001-29-2023%2005_27_32%20PM.gif?alt=media&amp;token=40ce9150-7e18-45a3-a938-62b8e9c95d54" alt=""><figcaption><p>Text Wrapping Options Demo</p></figcaption></figure>

### `New Line Mode`

Change the type of new lines used in the editor

**Options:**

* `Auto`
* `Unix`
* `Windows`

### `Use Soft Tabs`

Checking this will use spaces instead of 'hard' tabs

### `Soft Tab Size`

Number of spaces to use as tab. \
*Default: 4*

### `Show Invisible Characters`

Checking this will display spaces and tabs as visible characters in the Editor.

<figure><img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2F2zxvF5oWe4J9wlwqetqF%2FScreenshot%20from%202023-01-29%2017-34-28.png?alt=media&amp;token=e8120251-0ad8-44f3-a70f-9b0be32694fd" alt=""><figcaption><p>Show Invisible Characters Enabled - showing spaces and line endings</p></figcaption></figure>

### `Highlight Active Line`

Checking this will show the line the cursor is on by highlighting the entire line.

<figure><img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2Fbeazxr9PtIcsLCOmjHfp%2FScreencast%20from%2001-29-2023%2005_35_44%20PM.gif?alt=media&amp;token=45c9d6be-6ad7-4e46-940c-562987bea926" alt=""><figcaption><p>Highlight Active Line Enabled</p></figcaption></figure>

### `Show Folding Widgets`

Checking this will automatically show folding carats for foldable blocks of code (extensions,functions,ifs,...). This feature is required if Live Extension Validation is enabled

<figure><img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2FJh9f4m2oqq1h8vJ6xYbr%2FScreenshot%20from%202023-01-29%2017-44-05.png?alt=media&amp;token=944e0394-15ac-45ae-bf04-719aae717449" alt=""><figcaption><p>Folding Widget</p></figcaption></figure>

<figure><img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2Fd0y1AwXHlYFQD6BMl85b%2FScreenshot%20from%202023-01-29%2017-44-30.png?alt=media&amp;token=f177ff3f-bef4-4661-aae0-71e5f7838157" alt=""><figcaption><p>Folded Code</p></figcaption></figure>

### `Show Folding Widgets Only On Hover`

Checking this will only show folding carats for foldable blocks of code (`EXTENSION`,`FUNCTION`,`IF`, etc) while the mouse is over the Editor Gutter.

### `Show Gutter (line numbers, folding, info, warnings, breakpoints)`

Checking this will show the bar for Line numbering, folding widgets, extension validation, annotations, breakpoints, warnings and errors. Option provided to ease of use on extremely slim screens - otherwise not recommended as the features previously mentioned rely on this being enabled

### `Auto Indent`

Checking this draws visible columns to help display nested blocks

### `Display Indentation Guides`

Checking this draws visible columns to help display nested blocks

<figure><img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2FaVmKlpYrQ1fQdI0CAs4v%2FScreenshot%20from%202023-01-29%2017-47-37.png?alt=media&amp;token=24d2d3b9-965c-4438-b48c-ecb0c9c22b0a" alt=""><figcaption><p>Indentation Guides Enabled</p></figcaption></figure>

<figure><img src="https://2052920323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRgTCQkzfO7AUWTT3gFAq%2Fuploads%2FrCzKtkuHaO5rbjMWYGd3%2FScreenshot%20from%202023-01-29%2017-48-26.png?alt=media&amp;token=664016ea-60a1-4627-9403-b26adc61aace" alt=""><figcaption><p>Indentation Guide Disabled</p></figcaption></figure>

### `Display Print Margin`

Checking this draws an character margin line in the editor

### `Print Margin Width`

Number of characters wide to show print margin at. Default Value: 80

### `Escape key opens console`

Checking this will bind the ESCAPE key to open the console as well as close it

### `Always show Horizontal Scroll Bar`

Checking this will always show the editor's horizontal scrollbar regardless of the document's character width

### `Always show Vertical Scroll Bar`

Checking this will always show the editor's vertical scrollbar regardless of the document's character width
