# Layout debugging

With the shortcut ⌘ d you can quickly toggle layout debugging in your panes. This adds outlines to all the HTML elements on the pages letting you quickly analyze the HTML structure and find out which elements are causing layout issues.

It's like adding `* { outline: red}`, except much faster with different colors for different elements and support for pseudo elements.

![](/doc-img/horizontaloverflowdebug.png)

This debug tool can also be applied on a single pane using [Debug tools](/docs/debug-overlays/), where it's called "Layout debugging".

### Indicator in address bar

When layout debugging is active, a small indicator will appear on the right in the address bar. This way you can quickly see if the global layout debugging is active.

![](data:image/png;base64,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)

Click the indicator to disable layout debugging.

### Detecting horizontal overflows

Elements that cause a horizontal scroll bar/horizontal overflow are highlighted in red, making it easy to spot them. See [Horizontal overflow detection](/docs/horizontal-overflow/) for automatic detection before layout debugging is needed.

Read more about [detecting horizontal overflows](/blog/strategies-for-dealing-with-horizontal-overflows/).

### More layout debugging

The [Debug tab in the Elements Panel](/docs/elements-panel/#debug) shows you information on the offset parent and stacking context of each element along with CSS properties like `display`, `position` and `overflow` that are often the cause of layout issues.

To learn more about these concepts, check out our article [Offset parent and stacking context: positioning elements in all three dimensions](/blog/offset-parent-and-stacking-context-positioning-elements-in-all-three-dimensions/).

---

Polypane is the browser built for developers and designers — try it at https://polypane.app.
