1. Introduction
The Keychron Q7 is a 70% layout, all-metal custom mechanical keyboard designed for versatility and performance. It features a CNC machined aluminum body, double-gasket design, and supports QMK/VIA for extensive customization. This manual provides essential information for setting up, operating, maintaining, and troubleshooting your Keychron Q7 keyboard.

Image 1.1: Keychron Q7 Wired Custom Mechanical Keyboard with Gateron G Pro Blue Switches.
2. Package Contents
Before proceeding, please verify that all items are present in your Keychron Q7 package:

Image 2.1: Diagram illustrating the contents included with the Keychron Q7 keyboard.
- 1x Fully Assembled Keyboard (including Aluminum Case, PCB, Steel Plate, Sound Absorbing Foam, Case Foam, 10 Gaskets)
- 5 sets x Stabilizers
- 1 set x Keycaps (Double-Shot PBT)
- 1 set x Switches (Gateron G Pro)
- 1x Type-C to Type-C Cable
- 1x Type-A to Type-C Adapter
- 1x Switch Puller
- 1x Keycap Puller
- 1x Screwdriver
- 1x Hex Key
Note: All tools are typically located at the bottom of the packaging.
3. Setup
3.1 Connecting the Keyboard
- Locate the USB-C port on the back of the Keychron Q7 keyboard.
- Connect the provided Type-C to Type-C cable to the keyboard and your computer. If your computer only has USB-A ports, use the included Type-A to Type-C adapter.
- The keyboard is plug-and-play and should be recognized by your operating system automatically.

Image 3.1: Rear view of the Keychron Q7 showing the USB-C port and the Mac/Windows toggle switch.
3.2 Operating System Switch
The Keychron Q7 features a physical switch to toggle between Windows and macOS layouts. This switch is located on the back edge of the keyboard, near the USB-C port.
- Slide the switch to "Win" for Windows and Linux operating systems.
- Slide the switch to "Mac" for macOS.
Ensure the switch is set to your operating system for correct key functionality.
4. Operation
4.1 QMK/VIA Customization
The Keychron Q7 is fully compatible with QMK and VIA firmware, allowing for extensive customization of key assignments, macros, and lighting effects. VIA is a graphical user interface that simplifies the customization process without requiring firmware flashing.
- Download the VIA software from the official Keychron website or the VIA GitHub repository.
- Connect your Keychron Q7 keyboard to your computer.
- Launch the VIA application. The software should automatically detect your keyboard.
- Use the intuitive interface to remap keys, create macros, and adjust RGB lighting settings across multiple layers.

Image 4.1: Screenshot of the VIA software interface demonstrating key remapping and macro programming for the Keychron Q7.
4.2 Hot-Swappable Switches
The Keychron Q7 features hot-swappable sockets, allowing you to change mechanical switches without soldering. This supports most 3-pin and 5-pin MX-style mechanical switches.
- Removing a Switch: Use the provided switch puller. Gently grip the switch from the top and bottom clips and pull straight up.
- Installing a Switch: Align the pins of the new switch with the holes on the PCB. Ensure the pins are straight. Press the switch firmly until it clicks into place. Do not force it if resistance is met; check pin alignment.

Image 4.2: Close-up view of the Keychron Q7's hot-swappable switch sockets with various Gateron switches.
4.3 Double-Shot PBT Keycaps
The Q7 comes equipped with durable double-shot PBT keycaps in an OSA profile. These keycaps offer enhanced comfort, excellent oil resistance, and long-term legibility due to their manufacturing process where two plastics are molded together.

Image 4.3: Close-up of the Keychron Q7's double-shot PBT keycaps, highlighting their texture and profile.
4.4 South-Facing RGB Backlight
The keyboard features south-facing RGB LEDs. This design ensures that the backlight illuminates the key legends effectively from the typist's perspective and prevents interference with Cherry-profile keycaps, should you choose to install them.

Image 4.4: Illuminated south-facing RGB LEDs beneath the keycaps of the Keychron Q7.
5. Maintenance
5.1 General Cleaning
- Dust Removal: Use a can of compressed air to blow away dust and debris from between the keycaps.
- Surface Cleaning: Wipe the keyboard's aluminum case and keycaps with a soft, slightly damp, lint-free cloth. Avoid harsh chemicals or abrasive materials.
- Deep Cleaning (Keycaps): For thorough cleaning, keycaps can be removed using the provided keycap puller and washed with mild soap and water. Ensure they are completely dry before reattaching.
5.2 Component Disassembly and Assembly
The Keychron Q7 is designed for easy disassembly and assembly, facilitating modifications and maintenance. Refer to the exploded view diagram for component identification.

Image 5.1: Exploded view of the Keychron Q7, showing individual components like keycaps, switches, top case, plate, gaskets, sound absorbing foam, PCB, case foam, silicone gaskets, and bottom case.
When disassembling, use the provided screwdriver and hex key. Exercise caution to avoid damaging internal components or stripping screws. Reassemble components in reverse order, ensuring all connections are secure.
6. Troubleshooting
- Keyboard Not Responding:
- Ensure the USB-C cable is securely connected to both the keyboard and your computer.
- Try a different USB port on your computer.
- Verify the Mac/Windows switch on the back of the keyboard is set to the correct operating system.
- Test with a different USB-C cable if available.
- Specific Keys Not Working:
- Due to the hot-swappable design, a switch might not be fully seated. Gently remove the keycap and then the switch using the puller, then reinsert the switch firmly.
- If the issue persists, try swapping the problematic switch with a known working switch from another key to determine if the switch itself is faulty.
- Check VIA software to ensure the key has not been accidentally remapped or disabled.
- Backlight Issues:
- Ensure the backlight is enabled via the keyboard's function keys or through the VIA software.
- Adjust brightness settings.
- If only certain LEDs are not working, it might indicate a faulty LED or switch.
- QMK/VIA Software Not Detecting Keyboard:
- Ensure the VIA software is the latest version.
- Try restarting your computer and the VIA application.
- Ensure the keyboard is connected directly to your computer, not through a USB hub.
For further assistance, please refer to the Keychron official support resources.
7. Specifications
| Feature | Detail |
|---|---|
| Model | Keychron Q7 |
| Layout | 70% (72 Keys) |
| Body Material | Full CNC Machined Aluminum |
| Switch Type | Gateron G Pro Blue (Hot-swappable) |
| Keycaps | Double-Shot PBT, OSA Profile |
| Connectivity | Wired (USB-C) |
| Backlight | South-facing RGB |
| Firmware | QMK/VIA Programmable |
| Gasket Design | Double-Gasket Structure |
| Compatible OS | Mac, Windows, Linux |
| Product Dimensions | 13.44 x 4.76 x 1.33 inches |
| Item Weight | 5.17 pounds |

Image 7.1: Detailed specifications for the Gateron G Pro Blue Switch, including operating force, pre-travel, travel distance, and sound level.
8. Warranty and Support
8.1 Product Warranty
Keychron products are covered by a manufacturer's warranty against defects in materials and workmanship. The specific terms and duration of the warranty may vary by region and product. Please retain your proof of purchase for warranty claims.
8.2 Customer Support
For technical support, warranty inquiries, or additional information, please visit the official Keychron website or contact their customer service department.





