YUNZII X98

YUNZII X98 QMK/VIA Wireless Mechanical Keyboard User Manual

Model: X98 | Brand: YUNZII

1. Introduction

The YUNZII X98 is a 98% layout QMK/VIA compatible wireless mechanical keyboard designed for versatility and performance. It features tri-mode connectivity (wired, 2.4GHz wireless, and Bluetooth 5.0), hot-swappable switches, a gasket-mounted structure for enhanced typing feel, and vibrant RGB backlighting. This manual provides detailed instructions for setting up, operating, and maintaining your YUNZII X98 keyboard.

YUNZII X98 QMK/VIA Wireless Mechanical Gaming Keyboard

Figure 1: YUNZII X98 QMK/VIA Wireless Mechanical Gaming Keyboard.

YUNZII X98 Keyboard Features Overview

Figure 2: Overview of YUNZII X98 key features including 96% layout, tri-mode connectivity, 8000mAh battery, hot-swappable switches, QMK/VIA programmability, multi-function knob, full RGB, and gasket structure.

2. Package Contents

Please check the box for the following items:

  • YUNZII X98 Mechanical Keyboard
  • USB Type-C Cable
  • 2.4G Wireless Dongle (often stored in the keyboard's back compartment)
  • Switch and Keycap Puller
  • Extra Keycaps and Switches
  • Function Card & Manual
  • Dust Cover

3. Setup

3.1 Initial Charging

Before first use, it is recommended to fully charge the keyboard. Connect the provided USB Type-C cable to the keyboard's Type-C port and the other end to a USB power source (e.g., computer USB port, wall adapter). The keyboard features an 8000mAh battery.

YUNZII X98 Long-Lasting Battery and Charging

Figure 3: The YUNZII X98 features an 8000mAh battery, offering up to 45 hours with RGB on and 320 hours with RGB off. Charging takes approximately 13 hours.

3.2 Connectivity Modes

The YUNZII X98 supports three connection modes: Wired, 2.4GHz Wireless, and Bluetooth 5.0. Use the mode switch located on the side of the keyboard to select your desired connection type.

YUNZII X98 Connectivity Switch

Figure 4: Close-up of the mode switch for Bluetooth (BT), 2.4G Wireless, and Wired connections.

3.2.1 Wired Connection

  • Set the mode switch to the 'Wired' position.
  • Connect the USB Type-C cable from the keyboard to your computer.
  • The keyboard will be recognized automatically by your operating system.

3.2.2 2.4GHz Wireless Connection

  • Set the mode switch to the '2.4G' position.
  • Retrieve the 2.4G USB dongle from its storage slot on the back of the keyboard.
  • Plug the 2.4G dongle into an available USB port on your computer.
  • Press and hold FN + 4 to enter pairing mode. The indicator light will flash.
  • Once connected, the indicator light will become solid.
YUNZII X98 2.4GHz Wireless Connection Instructions

Figure 5: Steps for connecting the YUNZII X98 via 2.4GHz wireless mode, including locating the dongle and pairing.

3.2.3 Bluetooth Connection

The keyboard supports up to 3 Bluetooth devices.

  • Set the mode switch to the 'BT' position.
  • Short press FN + 1, FN + 2, or FN + 3 to select a Bluetooth channel.
  • Long press the selected FN + (1/2/3) key combination for 3-5 seconds to enter Bluetooth pairing mode. The corresponding key's backlight will flash rapidly.
  • On your device (PC, laptop, smartphone, tablet), search for Bluetooth devices and select 'YUNZII X98 BT1/BT2/BT3'.
  • Once paired, the key's backlight will stop flashing and remain solid for a few seconds before returning to the normal lighting effect.
YUNZII X98 Bluetooth Connection Instructions

Figure 6: Instructions for connecting the YUNZII X98 via Bluetooth, including channel selection and pairing process.

3.3 Adjustable Feet

The keyboard features adjustable feet on the underside to customize the typing angle for ergonomic comfort.

YUNZII X98 Adjustable Feet

Figure 7: Close-up of the adjustable feet on the YUNZII X98 keyboard, allowing users to modify the typing angle.

4. Operating Instructions

4.1 QMK/VIA Customization

The YUNZII X98 supports QMK/VIA open-source firmware, allowing for extensive customization of key mappings, macros, and RGB lighting effects. To use VIA, download the appropriate JSON file for your X98 model from the YUNZII official website and load it into the VIA software.

  • Key Remapping: Change the function of any key to suit your workflow or gaming style.
  • Macros: Create complex sequences of key presses and assign them to a single key.
  • Multiple Layers: Configure different key layouts for various applications or operating systems.
YUNZII X98 QMK/VIA Programmable Interface

Figure 8: The QMK/VIA interface allows for comprehensive customization of key settings, RGB lighting, and macros.

4.2 RGB Lighting Control

The YUNZII X98 features 16.8 million colors RGB backlighting with south-facing LEDs. You can control the lighting effects directly from the keyboard using FN key combinations or through the VIA software for advanced customization.

4.2.1 Onboard RGB Control

  • FN + Backspace: Toggle Backlight Effect ON/OFF
  • FN + Tab: Toggle White Light ON/OFF
  • FN + \|: Change Backlight Effect
  • FN + Enter: Change Backlight Color
  • FN + ↑: Increase Brightness
  • FN + ↓: Decrease Brightness
  • FN + ←: Increase Blinking Speed
  • FN + →: Decrease Blinking Speed
YUNZII X98 RGB Lighting Control Shortcuts

Figure 9: Visual guide to FN key shortcuts for controlling RGB lighting effects on the YUNZII X98.

4.3 Multi-Function Knob

The rotary knob on the YUNZII X98 provides convenient control over various functions. By default, it controls volume.

  • Rotate: Adjust volume (default).
  • Short Press: Mute/Unmute (default).
  • FN + Short Press: Change the RGB effect of the knob.
  • VIA Customization: The knob's function can be customized using VIA software to control other parameters like brightness, scroll, etc.
YUNZII X98 Multi-Function Knob Controls

Figure 10: The multi-function knob allows for volume control, muting, and changing its RGB effect with FN key combinations.

4.4 Hot-Swapping Switches

The YUNZII X98 is hot-swappable, allowing you to change mechanical switches without soldering. It is compatible with both 3-pin and 5-pin switches.

  • Removing Switches: Use the provided switch puller to carefully grip the switch and pull it straight up.
  • Installing Switches: Align the pins of the new switch with the holes on the PCB. Gently press the switch down until it clicks into place. Ensure the pins are not bent.
YUNZII X98 Hot-Swappable Switches

Figure 11: The YUNZII X98 supports full key hot-swapping, compatible with 3-pin and 5-pin mechanical switches.

4.5 FN Shortcuts

The keyboard includes various FN key shortcuts for quick access to system functions, compatible with both Windows and macOS.

YUNZII X98 FN Shortcuts for Windows and macOS

Figure 12: A detailed chart of FN key shortcuts for both Windows (FN+A) and macOS (FN+S) users, covering screen brightness, media control, and volume.

5. Maintenance

5.1 Cleaning

  • Use the provided dust cover when the keyboard is not in use to prevent dust accumulation.
  • For general cleaning, use a soft, lint-free cloth.
  • To clean between keycaps, use compressed air or a small brush.
  • For stubborn dirt, remove keycaps using the keycap puller and clean them with mild soap and water. Ensure they are completely dry before reattaching.

5.2 Switch and Keycap Replacement

Refer to section 4.4 for detailed instructions on hot-swapping switches. Use the provided keycap puller to carefully remove keycaps without damaging the switches.

6. Troubleshooting

  • Keyboard not responding: Ensure the keyboard is charged. Check the mode switch position (Wired, 2.4G, BT) and verify the connection. For wired mode, try a different USB port or cable. For wireless modes, re-pair the device.
  • Bluetooth connection issues: Ensure the keyboard is in Bluetooth pairing mode (FN + 1/2/3 long press). Remove previous pairings from your device and try connecting again. Ensure your device's Bluetooth is enabled.
  • 2.4GHz wireless issues: Ensure the dongle is securely plugged in. Try a different USB port. Re-pair the keyboard by holding FN + 4.
  • RGB lighting not working: Check if RGB is toggled off (FN + Backspace). Adjust brightness (FN + ↑/↓). If using VIA, ensure the lighting settings are correctly configured.
  • Keys not registering: If only specific keys are affected, the switch might be faulty. Try hot-swapping the switch with one of the extra switches provided. Ensure the switch is fully seated.
  • VIA software not detecting keyboard: Ensure the keyboard is connected via USB-C. Download the correct JSON file for the X98 model from the YUNZII website and load it into VIA.

7. Specifications

FeatureDescription
BrandYUNZII
ModelX98
Layout98% Layout (96 keys)
ConnectivityTri-Mode: USB-C Wired, 2.4GHz Wireless, Bluetooth 5.0
SwitchesPre-lubed Crystal Switches (Linear)
Hot-SwappableYes, compatible with 3-pin and 5-pin mechanical switches
Mounting StyleGasket Mount (5 layers of dampening materials)
KeycapsTransparent PC material, shine-through
BacklightingRGB, 16.8 million colors, South-facing LEDs
ProgrammabilityQMK/VIA compatible
Battery Capacity8000mAh
Compatible OSWindows, macOS
MaterialPlastic (transparent PC)
YUNZII X98 Gasket Mount Keyboard Exploded View

Figure 13: Exploded view of the YUNZII X98 gasket mount keyboard, highlighting its 5 layers of dampening materials for a satisfying sound and feel.

YUNZII X98 Pre-lubed Crystal Switch Specifications

Figure 14: Detailed specifications for the pre-lubed Crystal Switch, including type (Linear), pin (5-pin), operating force, end force, total travel, and pre-travel.

8. Warranty and Support

The YUNZII X98 keyboard comes with a 1-year warranty. For technical support, warranty claims, or any inquiries, please contact YUNZII customer service through the platform where you purchased the product or visit the official YUNZII website for support resources.

YUNZII Customer Support Guide

Figure 15: Guide on how to contact YUNZII customer support via Amazon, both before and after placing an order.

9. Product Videos

9.1 YUNZII X98 Unboxing and Typing Sound (Preview)

Video 1: A short preview showcasing the unboxing experience and the satisfying typing sound of the YUNZII X98 keyboard.

9.2 YUNZII X98 RGB Lighting Demonstration (Preview)

Video 2: A brief demonstration of the YUNZII X98's vibrant RGB lighting effects and color changes.

9.3 YUNZII X98 Features Overview (Preview)

Video 3: A quick overview of the YUNZII X98's design, connectivity options, and key features.

© 2026 YUNZII. All rights reserved.