---
title: buttonDisplay
---

Controls whether toolbar buttons display an icon, text, or both.

<div class='spec'>

string, *default:* `'auto'`

</div>

Accepted values:

- `'auto'` - uses the icon if the current theme defines one, otherwise falls back to text
- `'icon'` - icon only
- `'text'` - text only
- `'icon-text'` - icon on the left, text on the right
- `'text-icon'` - text on the left, icon on the right

This setting applies globally to all buttons. To override per-button, use the `display` property within a [buttons](buttons) entry.