How to Remap the Keys on Your Mac Keyboard

This guide will show you how to remap any of the keys on your Mac keyboard using a free and open source app for macOS.

Karabiner-Elements is a “powerful and stable keyboard customizer for macOS”. It lets you remap keys (change keys to other keys) and more advanced things like changing the caps lock key to control+option+command. Check out the full list of features here. You’ll need to be using macOS 11.0 (Big Sur) or 10.15 (Catalina) to use Karabiner-Elements.

This guide will show you how to install Karabiner-Elements and remap keys on your Mac keyboard.

  1. Download the .dmg from the Karabiner-elements home page. Open it up and run the installer file, Karabiner-Elements.pkg. Once the installation has completed, run from your Applications folder.
  2. Finder window with an arrow pointing to the file

  3. The first time you run Karabiner-Elements you’ll have to grant it a bunch of permissions, but this is a one-time only thing. Click the Open Security Preferences button when macOS tells you a System Extension has been blocked.
  4. macOS Security warning message

  5. Click the ‘lock’ icon in the bottom left corner of the window and enter your password when prompted. Then click the Allow button next to the message System software from application “” was blocked from loading.
  6. Security & Privacy section of the System Preferences for macOS

  7. Next you’ll be presented with a Input Monitoring Permissions Alert window – click the Open Security & Privacy System Preferences button.
  8. an arrow pointing to a button titled Open Security & Privacy System Preferences

  9. If the ‘lock’ icon is locked again, click it and enter your password. Then place a check in the box labeled karabiner_observer (it may be karabiner-grabber, see next step).
  10. an arrow pointing to karabiner_observer in the Privacy & Security System Preferences for macOS

  11. You’ll be prompted to repeat the above two steps with karabiner-grabber as well, unless that was the one you did first – in which case you’ll need to place a check next to karabiner_observer this time.
  12. With all of that out of the way, you should now be at the Keyboard Setup Assistant screen. Click the Continue button.

    an arrow pointing to a Continue button

  13. In order for the app to determine which keyboard layout it’s working with, you’ll need to tap a couple of keys. The first one is the key directly to the right of the Shift key on the left side of your keyboard. On a standard ANSI keyboard (US, Canada & others) that’s the z key.
  14. the Karabiner-Elements installer keyboard test screen one

  15. The next key you’ll need to tap is the one directly to the left of the Shift key on the right side of your keyboard. On a standard ANSI keyboard (US, Canada & others) that’s the ? (or / ) key.
  16. the Karabiner-Elements installer keyboard test screen two

  17. Once Karabiner-Elements has determined which keyboard you have, click the Done button.
  18. the last screen of the Karabiner-Elements setup wizard

  19. Now the main Karabiner-Elements window will appear – this is where you’ll configure your keyboard mappings. Let’s remap a key (you can always delete it later). Start by selecting the Simple modifications tab and then click the Add item button.
  20. the main Karabiner-Elements window
    click to enlarge

  21. Pull-down menus will appear in the From key and To key columns. Click the one in the From key column.
  22. an arrow pointing to a key button to remap on a Mac
    click to enlarge

  23. A big list of all the keys on your keyboard will pop up. Select the key that you want to change the behaviour of.
  24. select a key to remap on a Mac keyboard

  25. For this example I’m going to change my Right Shift key to a return key – because I often accidentally tap it instead of the return key, and I never use it otherwise.
  26. remapping the right shift key in macOS
    click to enlarge

  27. You can test out the changes you make by going back to your Applications folder and launching from there.
  28. an arrow pointing to in a Finder window

  29. You’ll need to grant it permission to receive keystrokes, so click the Open System Preferences button and do so.
  30. an arrow pointing to an Open System Preferences button

  31. Once you give it permission you’ll need to restart it, so click the Quit & Reopen button.
  32. a Quit & Reopen message screen in macOS

  33. Click inside of the Text input test field box and test out your newly remapped key.
  34. an arrow pointing to the Text input test field to test a key remap for Mac in Karabiner-Elements
    click to enlarge

  35. Now you know how to remap keys on your Mac’s keyboard! For more advanced options, be sure to check out their documentation. And last but not least, if you find this software really helpful, considering supporting Karabiner-Elements by making a donation.

If this article helped you, I'd be grateful if you could share it on your preferred social network - it helps me a lot. If you're feeling particularly generous, you could buy me a coffee and I'd be super grateful :)

buy a coffee for

Home » Mac » How to Remap the Keys on Your Mac Keyboard

Leave a Comment

Your email address will not be published.