Appearance
Keyboard style, key look, and the toolbar's shape.
The Appearance screen is where the keyboard’s look comes together. It’s the hub for the theme, font, and icon pickers, and it holds the sliders that shape the keys themselves and the toolbar above them.


Three rows that each open their own screen rather than settings inline:
- Keyboard themes: light, dark, AMOLED, and custom colors, background images, and theme import/export. Shows the active theme’s name, or “Default” when you haven’t picked one. Full details on Themes.
- Keyboard font: Google Fonts, or a font file you import yourself. Shows “System default” until you pick something else. Full details on Fonts.
- Icons: swap any tool or key icon individually, or install a whole icon pack. Shows “Default” with nothing changed, the active pack’s name once one is installed, or a count of individually-changed icons. Full details on Icon packs.
Reference pages for each of these three screens: Keyboard themes, Keyboard font, Icons.
WM Keyboard Appearance KeysThree sliders that apply to every key, whatever layout is active. All three are the global value, and a theme may override any of them:
| Setting | Range | Default |
|---|---|---|
| Key corner radius | 0–28 dp | 8 dp |
| Key label font size | ×0.7–×2.0 | ×1.00 |
| Key hint font size | ×0.5–×3.0 | ×1.00 |
| Key hint position | −6–16 dp | 1 dp |
| Key hint side position | −6–16 dp | 0 dp |
| Key label across | −12–12 dp | 0 dp |
| Key label up or down | −12–12 dp | 0 dp |
Key corner radius goes from square keys at 0 to fully pill-shaped keys at 28. Turn on “Corner radii for this theme” in the theme editor and it seeds that theme’s own key-radius slider from this value. See Themes for how a theme can override it.
Key label font size scales every printed letter on the keys themselves. It’s separate from the popup bubble that appears on a key press, which has its own size under Key press → Key popup.
Key hint font size scales the small corner hint on a key: the character or symbol a long-press on that key types. This slider only controls their size once they’re showing. The “Press and hold hints” toggle that turns the hints on or off in the first place lives on the Key press screen, not here. See Key basics for how long-press hints work.
Key hint position moves that corner hint up or down. At 0 the hint touches the top edge of the key. Raise it to bring the hint down toward the letter, or go below 0 to push it up into the key’s own margin. Key hint side position does the same sideways: higher numbers move the hint in from the key’s side, and below 0 moves it out to the edge.
Key label across and Key label up or down move the main letter on every key off its centre, so a corner hint made large enough to read, an Arabic haraka at ×2.5 for example, no longer sits under the letter. A layout can also make one key’s hint larger than the rest with its Hint size, in the layout editor.


Toolbar
Section titled “Toolbar”The toolbar is the strip above the keys that carries word suggestions while you type and your pinned tools otherwise.


| Setting | Type | Default | Notes |
|---|---|---|---|
| Show the toolbar | Toggle | On | Turning it off reclaims its height for the keys, but also hides suggestions and every pinned tool. You’re asked to confirm before it disables. |
| Where the tools go | The strip / A button / Always / On a swipe | The strip | The strip is the original arrangement: tools and suggestions share one row and the arrow flips between them, so the tools are only in reach when nothing is being suggested. A button and Always give the tools a row of their own above the suggestions. A button opens and closes that row from the same arrow. Always leaves it open instead. Either way, having the row up costs one row’s worth of keyboard height. On a swipe shares the strip again, but the strip rests on the suggestions: the tools come up only when you swipe up on the strip’s toolbox button and go when you swipe down on either toolbox button, and there is no arrow. Without that button on the strip, the arrow stays as the way in. Only shown while the toolbar is on. |
| Suggestion strip | Toggle | On | Keeps the suggestion row above the tools row. Turn it off to keep only the tools row and give the suggestion row’s height back to the keys, for example if you’ve turned suggestions off and the row sits empty. It also removes everything else that appears in that row: the paste chip for your last copy, one-time codes, snippet offers and other chips. Voice typing’s compact bar still takes the row while you dictate. Only shown while Where the tools go is set to Always, because with A button the arrow on the suggestion strip is how you open the tools. |
| Hide the strip until there are words | Toggle | Off | The other way round from The strip: the tools row stays, and the suggestion row folds away while it has nothing to show, before you start typing, in a field with no suggestions, or with a tool open. The first word to suggest, or a chip such as a one-time code or the paste chip, brings it back. The keyboard is one row taller while the strip shows. Only shown while Where the tools go is Always and Suggestion strip is on. |
| Toolbox button before the tools | Toggle | On | The toolbox launcher at the head of the pinned tools. Turn it off to leave the toolbox to the button beside the suggestions. With a tool open, the bar covers the strip, so the button is back for as long as the tool is. Needs Toolbox button under Emoji; without it the toolbar keeps its own. A swipe down on this button puts the tools away under The strip, A button and On a swipe. |
| Arrow to the tools | Toggle | On | The arrow on the suggestion strip that opens and closes the tools. Turn it off to do that with a swipe on a toolbox button instead: up on the strip’s to bring the tools, down on the toolbar’s to put them away. The arrow comes back while the toolbox button it would need is hidden. Needs Toolbox button under Emoji. Shown under The strip and A button. |
| Tools in landscape | Along the top / Left column / Right column | Along the top | With the phone on its side, takes the tools off the top of the keyboard and stands them in a column down the left or right edge, beside the suggestions and the keys, so they’re always in reach. If Where the tools go gave them a row of their own, that row’s height goes back to the keys. On the strip, the strip keeps only the suggestions and loses its arrow. The column follows the rest of the toolbar settings: your pinned tools and folders in their order, their colors and labels, the hold actions, Rearrange by dragging (drag up and down the column), and Tool layout, which spreads them down the column, packs them at the top, or lets them scroll. While a panel is open, the way back to the keys sits at the top of the column. A tool that takes the whole keyboard hides the column along with the rest of the bar, as does the toolbar-only view for a hardware keyboard. Portrait is unchanged. Only shown while the toolbar is on. |
| Swipe down to hide | Toggle | Off | A downward flick anywhere on the toolbar dismisses the keyboard. Only shown while the toolbar is on. |
| Press and hold delay | Slider, System or 100–1500 ms | System | How long you press a tool on the toolbar or in the toolbox before it counts as a hold: the hold action, the settings page, or picking the tool up. System follows the touch and hold delay in your phone’s accessibility settings. Only shown while the toolbar is on. |
| Rearrange by dragging | Toggle | On | A press and hold that moves picks the tool up so it can be dropped elsewhere on the toolbar. Off, a hold that moves stays a hold, and the toolbox is where the bar gets rearranged. For anyone whose hold keeps turning into a drag. Only shown while the toolbar is on. |
| Only the toolbar with a hardware keyboard | Toggle | Off | With a physical keyboard attached, drops the on-screen keys and keeps just the toolbar strip. A keyboard button at the end of the toolbar brings the keys back when you want them. |
| Hide the keys when I type on the hardware keyboard | Toggle | On | Keys brought back with the toolbar’s keyboard button go away again at the next key you type on the physical keyboard. Off, they stay until you tap the button. Only shown while Only the toolbar with a hardware keyboard and the toolbar are on. |
| Reverse the order for right-to-left languages | Toggle | Off | Mirrors the whole toolbar, toolbox button included, when the active layout’s script runs right-to-left. The buttons beside the suggestions follow the same switch: off, they keep their side and order. Only shown while the toolbar is on. |
| Tool layout | Fixed size / Spread out / Scroll | Spread out | Fixed size packs the pinned tools to the left at one size. Spread out splits the width evenly. Scroll keeps each tool at a comfortable size and lets the bar scroll sideways; change the order from the toolbox while it is on. Only shown while the toolbar is on. |
| Toolbar top padding | Slider, −12–24 dp | 4 dp | Space between the top edge of the keyboard and the toolbar. The strip carries both suggestions and the toolbar, so the suggestions move with it, and the keyboard gets taller by the same amount. Below 0 the strip gets shorter instead, down to 24 dp in all. |
| Toolbar bottom padding | Slider, −12–24 dp | 0 dp | Space between the toolbar and the first row of keys. The keyboard gets taller by the same amount. Below 0 the strip gets shorter instead, down to 24 dp in all. |
| Hide the toolbar and the clipboard on the lock screen | Toggle | Off | Hides the whole top strip and blocks the clipboard panel while the phone is locked, so nothing like a copied one-time code sits on a screen anyone can wake. See Tools for how this differs from the tools that work before first unlock. |
| Tool labels | Toggle | Off | Draws a caption under each pinned tool’s icon, the toolbox button at the head of the bar included (it reads Toolbox). Only shown while the toolbar is on. |
| Label text size | Slider, 7–14 sp | 10 sp | Only shown once Tool labels is on. |
| Keep labelled tools one width | Toggle | Off | Every labelled button keeps the tool width, and a longer name is cut short with an ellipsis instead of widening its button. Only shown once Tool labels is on. |
| Color the pinned tools | Toggle | Off | Gives the tools on the toolbar, and the buttons beside the suggestions, the colors they have in the toolbox, gradients included. Follows Colorful tool icons: with that off, there are no colors to give. Only shown while the toolbar is on. |
| Suggestion text size | Slider, 80%–160% | 100% | Scales the words in the suggestion strip without touching the strip’s own height. |
| Suggestion spacing | Slider, 0–24 dp | 6 dp | The gap either side of each word inside its slot. Lower it to fit more of a long word before it shrinks, or to pack more words onto a narrow screen. Raise it to keep neighbouring words apart once Scroll the suggestions is on. |
| Autocorrect word color | Color, or Auto | Auto | The color the strip paints its first suggestion in, but only once autocorrect has decided to put that word in for a space, so the color is a promise: a bold word without it is just the top guess, and a space keeps what you typed. Auto keeps the theme’s text color. |
| New word color | Color, or Auto | Auto | The color the strip paints a word that no word list, your personal dictionary, your contacts or the spell checker knows. That is usually the word you are typing, so you can see it would be new to the dictionary before you add it from its hold menu or the keyboard learns it on its own; the color goes as soon as either happens. The autocorrect word color wins where both apply, and neither is used on a layout that turns your keys into another script, where the strip shows readings rather than the word as typed. Auto keeps the theme’s text color. |
| Reset pinned tools | Button (confirms first) | n/a | Restores the global toolbar to Emoji, Clipboard, and Settings. It resets the global row even while a mode with its own pinned toolbar is active. To change what a mode pins, edit that mode instead. |
| Tool circle radius | Slider, 0–20 dp | 20 dp | 20 draws a full circle behind each tool icon, Gboard style. Smaller values give a rounded square. 0 removes the background, leaving bare icons. Has its own per-theme override in the theme editor. |
| Tool background shape | Row → picker dialog, the same twelve shapes as Key shape | Rounded | The outline of that background. Only Rounded and Cut read the radius above, and the rest size themselves off the button. Hidden while the radius is 0, since there is no background to shape. Has its own per-theme override in the theme editor. |
| Use my button size, not the theme’s | Toggle | Off | Lets the two sizes below win over the tool width your theme sets under Layout for this theme. Off, a theme with its own width keeps it and the width slider is greyed out. Only shown while the active theme sets a width, or once this is on. |
| Tool button width | Slider, 38–96 dp | 38 dp | How wide each button on the toolbar is: 38 is the circle, wider stretches it into a pill. It also decides how many tools fit before the row scrolls or shrinks. Only shown while the toolbar is on. |
| Tool button height | Slider, 28–64 dp | 38 dp | How tall each button on the toolbar is. A button never grows taller than the toolbar, so past about 40 dp raise Toolbar height under Layout & size too, or drag the toolbar taller with the Resize tool; the row says when the toolbar is capping it. Only shown while the toolbar is on. |
| Tool icon size | Slider, 14–30 dp | 22 dp | The icon inside each tool button, on the toolbar and in the toolbox grid. The button itself keeps its size, so the same number of tools fit either way. With Tool labels on, the icon draws 2 dp smaller (at most 26 dp) to leave room for the caption. |
| Reset toolbar (shown only once something on this screen has moved) | Button (confirms first) | n/a | Puts every slider and switch on this screen back to its default. Which tools are pinned is not affected. |
For the toolbox itself (pinning, reordering, and which tools work before you unlock your phone), see Tools.
Second toolbar
Section titled “Second toolbar”A second row of tools, picked apart from the ones pinned on the toolbar. The toolbar trades places with the suggestions in The strip arrangement, and tools pinned to it go out of reach while you type. This row doesn’t: it stays on screen while the strip shows words, with the toolbar switched off, and under every choice of Where the tools go. It suits the tools you reach for in the middle of a sentence, such as cut, copy, paste and the cursor moves.
| Setting | Type | Default | Notes |
|---|---|---|---|
| Second toolbar | Toggle | Off | Adds the row. The keyboard gets taller by one toolbar’s height, padding included, and the row follows Toolbar height and the resize tool’s toolbar handle. A tool that takes the whole keyboard hides it along with the other bars, and so does Hide the toolbar and the clipboard on the lock screen while the phone is locked. |
| Where it goes | Above the toolbar / Below the suggestions | Below the suggestions | Above the toolbar puts the row over the suggestion strip, and over the tools row when the tools have one. Below the suggestions puts it between the strip and the keys. The row is also an entry in the row order, where you can drag it anywhere else, below the keys included. Only shown while the row is on. |
| Tools on the second toolbar | Add, then drag to reorder | Select all, Cut, Copy, Paste, Line start, Line end, Undo, Redo | Tap Add to pick a tool from the same list the toolbar pins from. Drag a tool in the list to move it along the row, and tap its bin to take it off. A tool can be on the toolbar and on this row at once. Adding a tool that’s switched off under WM Keyboard Tools switches it on, and so does turning the row on for the tools already in it. Switch one off there later and the row leaves it out. Only shown while the row is on. |
The row’s buttons look and behave like the toolbar’s. They take Tool layout (spread out, or packed and scrolling once they outgrow the width), Tool labels, Color the pinned tools, the tool sizes and your theme’s toolbar color. The row stays while you search emoji or the clipboard. A hold works the same too: the cursor moves repeat, Selection mode holds, and a press and hold action you bound to a tool runs it. The row has no toolbox button and no back arrow, which stay on the toolbar, and its tools don’t drag: their order is set here. Reset toolbar leaves the second toolbar as it is.
Toolbox
Section titled “Toolbox”The toolbox is the grid of every tool behind the toolbar’s grid button. It is a different feature from the bar, so it has a page of its own.
| Setting | Type | Default | Notes |
|---|---|---|---|
| Reset toolbox order (shown only once you’ve dragged the grid around) | Button (confirms first) | n/a | Puts the tools in the toolbox grid back in their original order. The pinned bar is a separate list, reset by the row above. |
| Toolbox order | Your order / Most used / Recently used / A to Z | Your order | What puts the tools in order. Your order is the one you build by dragging. Most used puts the tools you open most often first, Recently used the one you opened last, A to Z sorts them by name. Tools never opened follow, in your order. The grid sorts itself as the toolbox opens, never while you tap in it, and a folder keeps its own order inside. |
| Toolbox layout | Icons / Pills | Icons | Icons is the round-icon grid with a caption under each tool. Pills gives every tool a wide rounded row instead: icon on the left, name beside it, and an arrow on the right for the tools that open something. |
| Toolbox grid size | Slider, 3–6 | 4 per row | Tools per row in the toolbox grid, the grid behind the toolbar’s grid button. Fewer per row makes each tool bigger; more fits more tools without scrolling. Only shown while the layout is Icons. |
| Pills per row | Slider, 1–3 | 2 per row | How many pills sit side by side. Only shown while the layout is Pills. |
| Fill the pills with the tool color | Toggle | Off | Colors the whole pill with the tool’s accent instead of just its icon, flipping the icon and name to whatever reads on top. Needs Colorful tool icons (under WM Keyboard Tools) to be on. Only shown while the layout is Pills. |
| Swipe the toolbox in pages | Toggle | Off | Breaks the toolbox into fixed pages you swipe sideways, with dots underneath, instead of one grid that scrolls. Applies to both layouts. |
| Tools per page | Slider, 4–40 | 12 per page | How many tools each page holds. Only shown once paging is on. |
| Toolbox label size | Slider, 0–16 sp (0 = follow the toolbar labels) | Follow toolbar | Sizes the captions in the toolbox on their own. At 0 the readout reads “Follow toolbar” and the captions take the toolbar’s label size instead. |
| Space around each tool | Slider, 0–16 dp | 10 dp | The space above and below each tool and folder in the toolbox’s icon grid. Less fits more rows on a page. The pill layout keeps its own spacing. |
| Toolbox search | Toggle | On | Shows a search button on the toolbar while the toolbox is open. The search opens over the whole keyboard with its own back button. Off leaves the toolbox with no search. |
| Search button at the far end | Toggle | On | Puts the toolbox search button at the far end of the toolbar, after the pinned tools, so a tap meant for back cannot open the search. Off moves it next to the back button. Only shown while Toolbox search is on. |
| Search order before typing | Your order / Most used / Recently used / A to Z | Your order | How the toolbox search lists every tool before you type anything. Once you type, the names that start with what you typed come first. Only shown while Toolbox search is on. |
| Reset toolbox (shown only once something on this screen has moved) | Button (confirms first) | n/a | Puts the grid layout, columns, paging, label size, the search button and its position, and both orders back to their defaults. The order of the tools, and which tools are switched on, are not affected. |
Details & edge cases
Section titled “Details & edge cases”- The Keyboard themes, Keyboard font, and Icons rows are shortcuts, not inline settings. Each opens its own full screen, so this page only covers what their trailing value means and where the real controls live.
- Key label font size and key hint font size are the global values, and a theme can override both.
ThemeSpeccarries its own nullablefontScale,hintFontScaleandboldKeyLabels, so a theme that sets any of them wins over these sliders until you switch to one that doesn’t. Key corner radius, tool circle radius, tool background width and tool background shape all work the same way. A theme can also set the toolbar’s height, which has no global slider; the toolbar top and bottom padding add to it either way. A row the active theme’s Layout for this theme group replaces says so under its name and greys out, so a slider that no longer reaches the keyboard is never mistaken for a broken one. The global value is kept and comes back the moment the theme stops setting it. See Themes for what a theme does and doesn’t control. - Press and hold a tool used to live here as its own screen. It moved onto each tool’s own page under Tools, where the row is called Press and hold on the toolbar. See Tools.
- Turning Show the toolbar off is the one toggle that asks you to confirm. Every other switch and slider here applies immediately, and turning the toolbar back on is instant with no confirmation. The reset buttons confirm too, since each one throws away an arrangement.
- Tool layout is one choice. Scroll used to be a second switch that silently overrode the spread one; the three options now say which layout you get.
- Reset appearance sits at the end of the Keys group and covers only the corner radius, the two label sizes and the hint position. The Toolbar and Toolbox pages each have their own reset.
- Reset pinned tools only touches the global toolbar row. A keyboard mode that carries its own pinned toolbar keeps it. You reset that from the mode’s own editor instead.
