It sounds like your machine may think the keyboard is ISO instead of ANSI. Some possible fixes for this problem can be found here.

Answer from Tom Gewecke on Stack Exchange
🌐
Apple Community
discussions.apple.com › thread › 255742229
Problems with keymapping and external key… - Apple Community
I have an external Keychron V3 keyboard plugged to my Mac* (but I had observed this with other external keyboards), configured in a Spanish input mode because, well, that's the keyboard I bought. However, the keys for < > (left to Z) and º ª \ (left to 1) seem swapped when I type. I have checked the Input mode in System Preferences and the only Spanish keyboard available that makes sense, indeed, has these two keys swapped in the layout ...
🌐
Apple Community
discussions.apple.com › thread › 256059080
Why is my Keychron K5 keyboard not recogn… - Apple Community
The Keychron itself probably also has a way to switch these the way you want them. Change the behavior of the modifier keys on Mac - Apple Support ... It's not just the left corner keys. Multiple keys do not match. When I look in the system settings and select input source into Finnish I can see the layout is wrong and does not match. It shows <> next to number 1 on keyboard ...
🌐
Reddit
reddit.com › r/keychron › keychron q2 keys not mapping properly on macbook air
r/Keychron on Reddit: Keychron Q2 keys not mapping properly on Macbook Air
July 23, 2024 -

The < and > symbols are producing the ^ and ° symbols.

I can see in the keyboard viewer that the < symbol is mapped to a key that doesn't exist on my keyboard.

I briefly got it to work by using cabled connection and changing keyboard type to something different and then back to ISO, but as soon as I tried the bluetooth connection is went back to the wrong keys.

Anyone know why this is happening and how to fix it?

Any help would be appreciated.

Thanks!

🌐
Reddit
reddit.com › r/keychron › keychron q1 problems with mac
r/Keychron on Reddit: Keychron Q1 problems with Mac
October 30, 2020 -

I received my keychron Q1 after waiting 3 weeks. I really like the keyboard to a point that I want to say I love it but the problems on Mac are very annoying.

1 - There is no way to use F1, F2, etc. keys as standard function keys. Yes, I have this option checked in my settings and it still does not work. I am a web developer and I frequently need to use F10 and F11 keys for debugging. On this keyboard having to use those with fn key is such a pain to a point that I don't think it's worth switching to this keyboard anymore.
2 - Special features on F1 to F6 do not work.

The support responds once in 24 hours and they completely ignore parts of the email. Am I the only Mac user who has those issues?

Top answer
1 of 5
14

(Thank you for the gold!)

Bit of a long comment as I spent a fair amount of time understanding how the Q1 and QMK functions on a Mac - the basic gist is that using Via or QMK will get you almost all of what you want, but it's useful to understand the reasons why you need to use it.

The reason that the toggle to use the function keys does not work on the Q1 is because Mac keyboards are (surprise) special snowflakes. On most keyboards, the `Fn` isn't actually a 'key' per-say, but switches the keys (or the layers) on a hardware level - the OS sees one key or the other, but has no idea that the FN key was pressed.

On a Mac though, the Fn key does function as a key - the media row of a Mac keyboard is always sent to the OS as F1, F2, F3 - but unlike a non-Mac keyboard, the OS is listening for the Fn, and uses that to determine to treat the keypress as a normal function key or as a media key. This is why the toggle in System Preferences does nothing regarding the Fn key for the Q1.

You can test this with your Q1 - open the Keyboard viewer. If you press the Fn key on a Mac keyboard, you'll see the virtual keyboard respond to the press, but the Q1 will not.

Only Apple keyboards can use the Fn key in the manner that macOS expects - but there is a hack around it. Many of Keychron's keyboards, Matias keyboards, and other Mac-specific boards change the hardware identifier in the keyboard to imitate a Mac keyboard - they use the same USB identifiers as Apple does, so the OS sees it as an Apple-sanctioned keyboard, and treats the FN accordingly.

However, Keychron does not do this on the Q1 because the firmware is QMT - and thus beholden to the QMT open source project. You can read the long PR here (https://github.com/qmk/qmk_firmware/issues/2179) but QMK (fairly) does not want to do the Fn hack as other keyboards do in that they don't want Apple coming after them for misusing hardware identifiers. There are ways to do this but it requires custom forks of QMT.

It's not really Keychron's 'fault' that the Q1 doesn't function identically a Mac keyboard - it's an unfortunate side effect of using the QMK firmware (which, to myself and many other buyers, is a main selling point for the board itself).

The Mac layout should still work though - when in Mac mode, all of the media keys should function normally because the Q1 is sending generic keypress events for the media keys that are defined in the USB spec. If, without any keyboard software running, and in Mac mode, the Q1 doesn't control the brightness/volume/etc - you might need to flash the firmware.

But - getting to your original point of having the function keys be the default - you do need to go into Via for that. On one hand, it's a pain that you have to do modifications to get the board to work the way you like, but on the other, without Via support you wouldn't be able to do this at all.

Changing the layers within VIA in Mac mode so the Function row is the default would take about five minutes - and, unlike the solution you have now where you swap the alt/command key in the OS - the changes are saved into the board itself, so it will work as you intend on any Mac.

What Keychron should do is explain this in their support - the Fn selector in System Preferences won't work, here's why, etc. It's not a bug, it's a result of how QMK functions in the Mac ecosystem, and is largely out of Keychron's control.

2 of 5
2

Omg that sucks because that’s why I go for Keychron since I use mac and love the function row. Just making sure, the switch on the top is set to Mac mode?

🌐
Reddit
reddit.com › r/keychron › unable to use keychron k2 with macbook in wired mode
r/Keychron on Reddit: Unable to use Keychron K2 with Macbook in wired mode
March 3, 2021 -

Every time I plug in my keyboard I get the following message:

https://preview.redd.it/a2cshsm6f5n61.png?width=770&format=png&auto=webp&s=a7efb2f386164382bd72cbaf9bb59947df1813c1

My Keychron does charge, but when I put it in wired mode it doesn't type anything. I'm using an adaptor to go from USB to USB C since my Macbook only has USB C ports and the cable delivered with the Keychron is USB C to USB... I was thinking about buying a third-party USB C to USB C cable but I'm not sure if the adaptor is the bottleneck here.

I really love my Keychron but I do think it's a serious blunder when you market your keyboards as Mac keyboards but you don't even provide a cable that fits in the Mac without adaptors.

Edit

Based on some of the comments I can add some additional information

  • Bluetooth does work.

  • Switching USB C port does not solve the issue

  • Using wired mode on a different laptop with USB A does work

  • I'm using a Dell DA300 adapter

So I think the quick fix for me is just buy a third-party USB-C to USB-C cable.

Edit 2

I purchased a third-party USB C to USB C cable and everything works as expected now for me.

🌐
Apple Community
discussions.apple.com › thread › 254571759
Macos detected wrong keyboard layout - Apple Community
I find proposed solutions for this problem by restarting the keyboard detection wizard but to do this I would have to delete the 'com.apple.keyboardtype.plist' file in Library/preferences/ but can't find it on my MacBook. I also can't find any other way to change to the correct layout (The correct layout is not an option when trying to add a new input layout)
🌐
Keychron
keychronsupport.zendesk.com › hc › en-us › articles › 36539573557271-Fixing-Swapped-Keys-on-Your-Mac
Fixing Swapped Keys on Your Mac – Keychron | Support Center
When prompted, select the correct layout for your keyboard: ISO (common in Europe) or ANSI (common in the US). ... Unplug your keyboard. Open Finder. Press Shift + Command + G to open the "Go to Folder" window. ... Restart your Mac. Plug your keyboard in again. What should I do if my keyboard keys have a double-click issue, require multiple presses, or require extra force to work? My keyboard is not recognized by Keychron ...
Find elsewhere
🌐
Keychron
keychron.com › blogs › news › keychron-mac-layout-design
Keychron Mac Layout Design
November 12, 2025 - Keychron Mac Layout Design Mac Layout + Mechanical Keyboard Keychron is one of the best mechanical keyboards for the Mac OS. The Mac layout has the same media and function keys as the Mac keyboard. It’s the layout you’re used to, but in a mechanical keyboard.
🌐
Keychron
keychron.com › pages › keychron-keyboard-layout-text-version
Keychron Keyboard Layout (Text version)
The keyboard has a USB-C connector on the middle, 13mm from the top side panel. Following the USB-C connector, there are two toggle switches on left from the top side panel: Mac/Windows, Cable/Off/Bluetooth. K5 and K5SE Ultra-slim (Full-size Layout) Top row: esc Screen-brightness-down Screen-brightness-up Launch-Pad Mission-Control Keyboard-backlit-down Keyboard-backlit-up Previous-track Play-Pause Next-track Mute Volume-down Volume-up Screen-capture Siri/Cortana Light-effect-key Top row (activate by fn): Blank f1 f2 f3 f4 f5 f6 f7 f8 f9 f10 f11 f12 Second row: ` 1 2 3 4 5 6 7 8 9 0 - = backspace ins home Page-up num/clear / * - Second row (activate by shift): ~ !
🌐
Keychron
keychron.com › blogs › news › how-to-switch-keyboard-language-on-mac
How to Switch Keyboard Language on Mac (Step-by-Step Guide) – Keychron
January 23, 2025 - Go to System Preferences > Keyboard > Input Sources and make sure the correct layout is selected. ... Go to Keyboard > Text Replacement and look for any replacements causing unexpected changes.
🌐
Reddit
reddit.com › r/keychron › help needed: keychron v6 knob - swapped keys issue on macos with spanish iso layout
r/Keychron on Reddit: Help Needed: Keychron V6 Knob - Swapped Keys Issue on macOS with Spanish ISO Layout
April 14, 2024 -

I have a Keychron V6 Knob version keyboard (Spanish ISO model) that I'm using on macOS, and I've run into a small issue that I hope you can help me resolve. The keys for the greater than (>) and less than (<) symbols, along with the keys for the characters º and ª, are swapped. My regional and language settings are all correct, set to Spanish from Spain.
I've tried some tools like Karabiner-Elements and Ukelele to try to fix it, but I can't even find these specific keys in their options, or I can't get the change to work.
Has anyone had this problem and knows how to solve it? Is there any firmware update I should try or a specific setting that works well with macOS? Any suggestion would be greatly appreciated.

🌐
Keychron
keychronsupport.zendesk.com › hc › en-us › articles › 360044587973--How-do-you-switch-between-the-Mac-and-Windows-keyboard-layout
How do you switch between the Mac and Windows keyboard layout? – Keychron | Support Center
If not, is there any workaround? ... You don’t need to choose the system preference with our keyboards. The keycaps for both Mac and Windows layout are included in the box. You will just need to pick the right keycaps from the box and install them on the keyboard.
🌐
Reddit
reddit.com › r/keychron › any keyboards with a macbook layout?
r/Keychron on Reddit: Any keyboards with a MacBook layout?
August 4, 2023 -

I find that the longer I type on a mechanical, the harder it becomes to type on a MacBook keyboard.

I would love a mechanical that has the exact same layout as the MacBook keyboard.

This means a full-size right shift key. Small inverted T arrow keys below the right shift. And a `fn` key on the left. Also the alignment of the function keys is important.

The NuType F1 had a Mac function key at least - but not the rest of it. It's now discontinued. https://nuphy.com/collections/keyboards/products/nutype-f1

Is there anything else?

Would it be hard to DIY?

🌐
Keychron
keychron.com › blogs › news › solved-hidden-problem-of-k2
Solved: Hidden Problem of K2 – Keychron
December 24, 2019 - Regarding a recent issue to get § and ± when you type ` (backquote) and ~ (tilde) on K2 wireless mode while using macOS. We gathered up the whole production team and necessary factory suppliers in a few hours to talk face to face. We finally found the reason and solution to fix it in a few days, and we take this chance to improve our quality check process to ensure all future Keychron keyboards meet our highest quality requirements.
🌐
Ghostty
perrotta.dev › 2022 › 04 › keychron-k2-on-macos-fix-home-and-end-keys
Keychron K2 on macOS: fix Home and End keys
April 22, 2022 - Expectations vs Reality For example, ... line (à la C-e in emacs) The only way to provoke these effects out-of-the-box is by pressing, respectively, the Cmd + Left and Cmd + Right shortcuts, as you would normally do in a Macbook laptop native keyboard....