> ## Documentation Index
> Fetch the complete documentation index at: https://docs.minimalmacropad.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Change a Key in MinimalPad Studio for Browser

> Remap any key on any layer in the MinimalPad browser configurator — pick a category, configure the action, assign it, and save.

Every key on every layer is configurable. Change one in under a minute, test it immediately, and save when you're happy.

<Steps>
  <Step title="Connect your pad">
    Open [Studio](https://studio.minimalmacropad.com/) and connect over USB or Bluetooth — see [Connect](/browser/connect). When the indicator turns green, you can edit.
  </Step>

  <Step title="Pick the layer">
    Click a layer tab at the top. The grid updates to show that layer's assignments.
  </Step>

  <Step title="Click the key">
    Click any key in the 4×4 grid, or the dial's press button, to open the action picker.
  </Step>

  <Step title="Choose a category, or search">
    The picker opens with six categories and a search bar:

    * **Shortcut** — several keys together, such as ⌘C or Ctrl+Shift+Left
    * **Single key** — one letter, number, arrow, symbol, or function key
    * **Media & apps** — playback, volume, brightness, browser and app controls
    * **Layers** — hold, toggle, or switch to another layer
    * **Device controls** — Bluetooth profiles, lighting, USB output, system actions
    * **Advanced** — dual-action behaviours, sticky keys, and every ZMK behaviour in your firmware

    Search by name if you'd rather — try "tap hold", "brightness", or "Bluetooth".
  </Step>

  <Step title="Configure the action">
    Set its parameters: which key to send, which layer to target, which Bluetooth profile, which lighting adjustment. Some actions need nothing extra.
  </Step>

  <Step title="Click Assign to key">
    Studio sends the change to your pad immediately and the key label updates.
  </Step>

  <Step title="Save">
    Click **Save** in the connection bar to write it to the pad's memory so it survives a reboot.
  </Step>
</Steps>

<Tip>
  Test the key right after assigning it, before you save. If it isn't right, adjust it and assign again — only save once you're happy.
</Tip>

<Warning>
  Disconnecting before you save loses unsaved changes, and the pad reverts to its last saved configuration. See [Save & discard](/browser/save-and-discard).
</Warning>

## What each category is for

| Category        | Best for                                        |
| --------------- | ----------------------------------------------- |
| Shortcut        | Multi-key combinations with modifiers           |
| Single key      | Any individual keycode                          |
| Media & apps    | Volume, playback, display brightness            |
| Layers          | Layer switching — see [Layers](/browser/layers) |
| Device controls | Bluetooth profiles, lighting, USB/BT output     |
| Advanced        | Tap/hold, sticky keys, firmware macros          |

For what each action actually does on the pad, see [What a key can do](/configure/key-actions).

## Advanced behaviours

The **Advanced** category exposes every ZMK behaviour your firmware was built with. The ones people reach for most:

| Behaviour        | What it does                                                      |
| ---------------- | ----------------------------------------------------------------- |
| **Mod-tap**      | Tap for a key, hold for a modifier like Ctrl or Shift.            |
| **Layer-tap**    | Tap for a key, hold to switch layers.                             |
| **Sticky key**   | Tap a modifier and it applies to just the next key press.         |
| **Caps word**    | Capitalises one word, then turns itself off at a space or symbol. |
| **Key toggle**   | Press to hold a key down, press again to release.                 |
| **Grave/escape** | Escape on its own, backtick with Shift or Cmd held.               |

<Note>
  These aren't available in [Studio for Mac](/mac/change-a-key), which keeps to shortcuts, keys, media, layers, Open app keys, and the pad's own commands.
</Note>

## The dial

The dial's **button** is a normal key position — click it and assign it like any other.

What the dial does when you **turn** it is set in the firmware and shows as read-only here. Changing it means rebuilding the firmware; see [Advanced customization](/firmware/advanced).