Troubleshooting | splitkb.com documentation

If you're having any trouble with your keyboard, it can help to look through our list of troubleshooting guides. We have solutions for the most common issues.

While having an issue is frustrating, most of them can be solved. If you have any questions along the way or if you are unable to find a solution in the troubleshooting steps or in the product guides, please feel welcome to reach out for help.

In this section

In this section, you'll find the following pages:

Main section

All of the top-level pages.

Troubleshooting switches

Fixing issues with a switch, or a row or column of switches.

Troubleshooting RGB LEDs

Having an issue with RGB? Here are the steps to fix it.

I'm experiencing latency or dropped keystrokes

Steps to follow when input is slower or missing entirely.

Pressing an encoder doesn't provide output

If pressing doesn't work, but turning does, you may need to adjust the height of your encoder knob.

My encoder is skipping actions when turning it

If you're using QMK or Vial, you may need to change your encoder's resolution.

I can't flash my keyboard

For your firmware flashing troubles

The keyboard won't power on

Steps to follow when your keyboard won't power on after plugging it in.

The keyboard won't send output

Steps to follow when your keyboard does power on, but won't provide output.

Only one half of my keyboard works at a time

Steps to follow when the halves are having trouble working together.

My keyboard layout is mirrored

Steps to follow when the left half acts as the right, and the other way around.

The OLED display doesn't work

If your OLED display doesn't work, here are some steps you can try to fix it.

The keyboard behaves erratically after changing the RGB settings

Excessive power draw can cause a keyboard to act up. Here's how to limit the power draw and get your keyboard back in business.

Troubleshooting switches

Fixing issues with a switch, or a row or column of switches.

Questions? Help us improve!

Do you have questions after reading the documentation? Do you have feedback about this page, or about the documentation in general? Please send us an email. You can use the buttons below which will open your mail client or app with a template, or send your mail to support@splitkb.com.

I have a question I'd like to share feedback