How to Build a Custom Keyboard: The Complete Beginner’s Guide (2026)

Last updated on April 12th, 2026 at 03:02 pm

Building a custom keyboard looks intimidating. Soldering irons, switch pullers, PCBs, stabilizers – it’s a lot. But here’s the truth: it’s far easier than it seems when you follow a clear path.

This guide walks you through every step, from picking compatible parts to assembling a keyboard you’ll actually use daily. By the end, you’ll have a finished board on your desk and – more importantly – you’ll understand why it feels, sounds, and performs the way it does. That’s the difference between owning a keyboard and truly knowing your tool.

Time commitment: 2–6 hours.

• Hot-swap build → 2–3 hours, no soldering, great for first-timers.
• Soldered build + mods → 4–6 hours, more flexibility, deeper customization.

Either way, you’re not just assembling parts. You’re building something you can tweak, upgrade, and improve for years.

Figure: A collection of custom mechanical keyboards showing different layouts, styles, and lighting setups.

Before buying a single part, you need to decide which type of build matches your goals. Your choice affects cost, time, tools needed, and how much flexibility you’ll have later.

Which build path fits your goals? Answer the two questions to find your ideal starting point.

• Hot‑swap kit assembly – The most popular starting point. You buy a complete kit (case, PCB, plate) that supports hot‑swap sockets. No soldering required. You simply clip in switches and snap on keycaps. Perfect if you want to try different switches later without permanent commitment. Time: 2–3 hours.
• Full DIY (soldered) – You select every component individually: case, PCB (solder version), plate, switches, stabilizers, and keycaps. You’ll solder each switch to the PCB. This path gives you total control over layout, mounting style, and materials. It’s also the only way to use certain premium components or non‑standard layouts. Time: 4–6 hours.
• Pre‑built modding – You start with an off‑the‑shelf mechanical keyboard (like a Keychron, Ducky, or even a budget board) and modify it. Common mods include swapping switches, replacing keycaps, lubricating stabilizers, and adding case foam. It’s a low‑risk way to learn the basics without buying a full DIY kit. Time: 1–2 hours for basic mods.

Not sure about a specific component? Jump to the Parts Compatibility Matrix to avoid mismatched purchases.

Once you’ve chosen your build path, the next challenge is making sure every component actually works together. Beginners often buy a beautiful case and a PCB that doesn’t fit, or fall in love with switches that won’t snap into their hot‑swap sockets. This matrix saves you from those costly mistakes.

Figure 1: Exploded view of a typical 60% hot swap keyboard. Note the plate sits between switches and PCB, while stabilizers mount to the plate (plate mount version shown).

Let’s break down each row so you can shop with confidence.

The PCB (printed circuit board) decides your keyboard’s size, layout, and whether you’ll need a soldering iron. Hot‑swap PCBs have sockets that grip switch pins; solder PCBs require you to melt metal onto each connection. Always match the PCB’s layout percentage to your case – a 65% PCB won’t line up with the screw holes of a 60% case, leaving you with a useless plate.

Related: What are Mechanical Keyboard PCBs?

Cases aren’t just decorative. They determine the mounting style (how the PCB and plate sit inside), which affects typing feel and sound. A tray‑mount case screws the PCB directly to the bottom – stiff and consistent. Gasket‑mount uses foam or silicone strips to create a softer, bouncier feel. The critical check: make sure the case’s standoffs align with the mounting holes on your PCB. One wrong hole and you can’t close the case.

The plate sits between the PCB and keycaps, holding switches in place. Common materials: brass (stiff, bright sound), polycarbonate (flexible, deep sound), and aluminum (balanced). Layout support matters more than you think – a plate designed for a 6.25U spacebar will leave a 7U stabilizer with nowhere to clip in. Always check the plate’s cutout diagram before buying.

Figure 2: 5 pin switches (right) have two additional plastic legs. They will not fit into 3 pin hot swap sockets unless you clip off the extra pins.

This is the most overlooked trap. Switches come with either two plastic pins plus a metal pin (3‑pin total) or two extra plastic stabilizing pins (5‑pin total). Many hot‑swap PCBs only accept 3‑pin switches. If you buy 5‑pin switches for a 3‑pin socket, you’ll have to clip off the extra plastic pins – it’s doable but tedious.

Related: Keyboard Switch Leaves Explained.

Before you hit checkout, run through this:

• PCB layout percentage matches case.
• PCB screw holes align with case standoffs.
• Plate cutout supports your chosen stabilizer size (6.25U or 7U).
• Switches are 3‑pin if your PCB is 3‑pin hot‑swap (or you’re ready to clip 5‑pin).
• Stabilizer mounting type (PCB‑mount/plate‑mount/screw‑in) matches your PCB holes.

This table and checklist are your map. Skip it, and you’ll likely waste money on parts that don’t speak the same language. Follow it, and your build will click together on the first try.

Before you order parts, gather the right tools. Nothing kills momentum like waiting days for a $5 switch puller to arrive.

Below is everything you’ll need, split by build path. Tick off each item as you go.

Figure: Essential tools grouped by build path. Hot swap needs only a few items; soldering and lubing require additional gear.

That’s it for a basic hot‑swap build. Four tools, no soldering iron required.

Add these to the list above if you chose the Full DIY (Soldered) path:

• Soldering iron – TS100 or Hakko FX888D are reliable starters.
• 60/40 solder (leaded) – Easier to work with than lead‑free.
• Flux – Helps solder flow cleanly; prevents cold joints.
• Desoldering pump – For fixing mistakes (you will make them).
• Fume extractor – Your lungs will thank you. A small fan + open window works too.
• Helping hands – Holds the PCB steady while you solder.

Nice‑to‑Have (Any Build)

These make the process smoother, cleaner, and more satisfying:

• Switch opener – Opens switch housings without stabbing yourself.
• Lube station – Holds switch bottoms while you apply lubricant.
• Krytox 205g0 – The gold standard for linear and tactile switches.
• Brush set – Small, fine‑tip brushes for even lube application.

Related: Once you have your lube and brushes, learn the proper technique in our guide: How to Lube Mechanical Keyboard Switches.

Once your tools arrive, you’re ready to build. Next up: Step‑by‑step assembly – starting with the most important rule: test your PCB before you do anything else.

Now comes the rewarding part: turning a box of components into a keyboard you can actually type on. Follow these steps in order. Skipping ahead – especially testing the PCB – is the #1 cause of “why won’t this work?” panic posts on Reddit.

You have a shiny new PCB. Resist the urge to install switches immediately. First, you need to verify that every single key socket works.

1. Plug the PCB into your computer via USB‑C (or whatever port it uses).
2. Open a free keyboard tester website like keyboardtester.com or VIA’s built‑in tester.
3. Grab a pair of metal tweezers. Touch both pads (or the two small holes) inside a switch socket at the same time – this simulates a keypress.

Figure: Using tweezers to short switch contacts on a PCB to simulate a keypress during testing.

4. The tester should highlight that key. Repeat for every socket on the board.

Why this matters: If a socket is dead from the factory, you want to know before you solder or clip in switches. Returning a bare PCB is easy. Returning a PCB with 60 switches installed is a nightmare.

First, try shorting it again – maybe you missed the pads. Still dead? Check if the PCB has a “reset” button or try reflashing the firmware. If nothing works, contact the seller for a replacement.

Stabilizers – those wire assemblies under long keys (spacebar, shift, enter, backspace) – are the main source of rattle in a custom keyboard. Lubing them before installation is 10x easier than after.

• Your stabilizer set (PCB‑mount or plate‑mount, as determined in the compatibility matrix)
• Krytox 205g0 or a similar thick lube
• Small brush
• Wire clippers (for clipping legs on some stabs)

1. Clip the legs (if your stabilizers have extra plastic feet). This allows the stab to bottom out smoothly. Not all stabs need clipping – check your specific model.
2. Disassemble each stabilizer – separate the wire from the housing and the stem.
3. Lube the wire: Apply a thin coat of Krytox to the “elbows” of the wire (the bent parts that go into the stem). Don’t overdo it – a little goes a long way.
4. Lube the housing: Brush a thin layer inside the channels where the stem slides.
5. Reassemble and insert the stabilizer into the PCB (for PCB‑mount) or snap it into the plate (for plate‑mount).

Watch how to properly lube stabilizer wires for a smoother, rattle-free sound. Video by Taeha Types on YouTube.

Common mistake: Using too much lube. It will make the key feel mushy and attract dust. You want a visible film, not a glob.

Once your stabilizers are lubed and installed, give each wire a gentle tap – you should hear a solid, quiet thud, not a metallic rattle.

Now you reach the fork in the road. Your build path determines how switches go in.

Figure: Two ways to install switches – hot swap (left, no soldering) and soldered (right, requires iron and solder). Refer to the section that matches your build.

1. Inspect each switch. Look at the pins. Are they perfectly straight? Even a slight bend can miss the socket hole.
2. Align the switch so the pins line up with the socket holes on the PCB. The switch should sit flush against the plate.
3. Press firmly – you should hear a distinct click when the switch snaps into the plate. Do not press so hard that you bend the PCB.
4. Check visually from the side: the switch bottom should touch the PCB surface. If there’s a gap, the pins aren’t seated.

Related: For a deeper dive with photos, see our dedicated guide: How to Install Switches On Hot‑Swap Keyboards.

Warning: If you feel resistance, stop. Do not force. Remove the switch, check for bent pins, straighten them carefully with tweezers, and try again. Forcing a bent pin can rip out the hot‑swap socket from the PCB – a repair that requires soldering.

1. Insert each switch into the plate and PCB. Make sure the switch is fully seated – the two plastic pins should go through the PCB holes.
2. Flip the PCB so the solder pads face up. Use a helping hands tool or a soft foam block to keep it stable.
3. Heat the pad and the pin simultaneously with your soldering iron (set to 300°C / 570°F for leaded solder).
4. Feed solder into the joint where the iron meets the pin – not onto the iron tip. You need about 2‑3 seconds of heat.
5. Remove solder first, then iron. Let the joint cool without moving the switch. A good joint looks like a shiny volcano cone.

Mistakes happen. If you bridge two pins (solder connects them), use a desoldering pump to remove the excess and try again. Cold joint? Reheat and add a tiny bit of fresh flux.

You’re almost there. With all switches installed, it’s time to put on the keycaps.

• Start from the corners – place keycaps on the four corner switches first. This stabilizes the plate and PCB.
• Press straight down – don’t rock the keycap side to side. That can bend switch stems or damage hot‑swap sockets.
• Work row by row – bottom row (spacebar, alt, ctrl), then alphas, then modifiers, then numbers, then function row (if any).

Figure: Recommended keycap installation order: start from the bottom row, then letters, modifiers, and number row.

• For the spacebar: Install the stabilizer wire first, then snap the spacebar keycap onto the switch stem. Make sure both stabilizer stems move freely.

Keycap material and profile matter. Different profiles (SA, OEM, Cherry, etc.) have different heights and shapes. Mixing profiles can feel odd. If you’re curious about the differences, check out our guide: What are Double Shot Keycaps.

Final check: After all keycaps are on, run your fingers across the board. Any key that feels loose or crooked? Pull it off (using a keycap puller) and reseat it. Any key that doesn’t return? The switch or stabilizer might be binding – investigate before you declare victory.

Plug the keyboard in again. Open the same keyboard tester. Press every key. Listen for consistent sound. Feel for even resistance.

If everything works, congratulations – you’ve built a custom keyboard.

If something feels off, don’t panic. The next section (Troubleshooting Flowchart) will help you diagnose and fix the most common issues.

Your keyboard is assembled, every key types correctly, and the stabilizers don’t rattle. Now comes the secret sauce that separates a basic board from a truly custom one: firmware configuration. Most pre‑built keyboards lock you into a fixed layout. With a custom mechanical keyboard, you can reassign any key, create macros, switch layers, and even change what a key does when you hold it versus tap it. All of that happens in software – no soldering required.

VIA is a graphical program that talks to your keyboard in real time. No compiling, no command line. Just download, open, and click.

• A keyboard with a compatible microcontroller (most hot‑swap PCBs from brands like Keychron, KBDfans, and YMDK support VIA).
• The VIA application (available for Windows, Mac, and Linux).

1. Launch VIA. It should automatically detect your keyboard.
2. Click on the key you want to change (the on‑screen keyboard highlights it).
3. Pick a new function from the dropdown – anything from a standard letter to “Layer 2,” “RGB toggle,” or “Media Play/Pause.”
4. That’s it. The change happens instantly. No flashing, no rebooting.

Live demo of remapping keys in VIA video by Arcamus on YouTube

Loading a JSON file: If VIA doesn’t recognise your board, you may need to download a .json configuration file from your PCB vendor, then drag and drop it into the “Design” tab of VIA. After that, your keyboard appears.

Macros: Record a sequence of keystrokes (e.g., :wq for Vim or your email address) and assign it to any key. VIA’s macro recorder is built into the “Macros” tab.

VIA supports up to 16 layers. You can set a key to momentarily switch to layer 1 (like holding Fn) or toggle a layer. That’s how 60% boards type arrow keys and function row without dedicated keys.

Related: Dive deeper into the differences and advanced features in our guide: What are VIA and QMK for Mechanical Keyboards?

QMK (Quantum Mechanical Keyboard) firmware is what powers VIA under the hood. But QMK itself requires you to edit code and compile the firmware.

• Your PCB isn’t VIA‑compatible.
• You need features VIA doesn’t expose (e.g., custom tap‑dance behaviours, mouse keys, or complex combo actions).
• You enjoy tinkering with code.

1. Set up the QMK environment (follow the official QMK tutorial).
2. Edit keymap.c – a text file where you define every key’s behaviour.
3. Compile the firmware into a .hex or .bin file.
4. Flash it to your keyboard using QMK Toolbox (or command line).

It’s more work, but it unlocks near‑infinite customisation – from “caps lock becomes backspace when tapped, control when held” to entirely new keyboard layouts.

Ninety‑five percent of custom keyboard users never need to touch QMK directly. VIA handles remapping, macros, and layers with zero coding. Only move to raw QMK if you hit a limit or simply enjoy the process.

You’ve built a keyboard that looks great and types perfectly. But does it sound the way you want? That deep, satisfying “thock” – not a high‑pitched clack or a hollow echo – is what many builders chase. The good news: you can shape the sound dramatically with a few cheap (or free) mods.

Below are the most effective sound modifications, ordered from least to most expensive. Try them one at a time so you hear what each change does.Not sure what “thock” actually means? We’ve got a full breakdown: What Does “Thock” Mean?

Flip your PCB over and apply 2–3 layers of blue painter’s tape (masking tape) directly onto the back of the PCB, covering the area under the switches. This dampens high‑frequency echoes and deepens the sound. It’s free, reversible, and shockingly effective.

Figure: Tape mod applied to a PCB. Do not cover screw holes or the USB C port.

How to: Cut strips of tape, lay them flat without wrinkles, and press firmly. Avoid covering any screw holes or the USB port.

A thin sheet of polyethylene (PE) foam – the kind used for packaging electronics – placed between the PCB and the plate. PE foam adds a soft, marble‑like “pop” to the thock. You can buy precut sheets or cut your own from any clean packaging foam.

Figure: Polyethylene (PE) foam sheet placed between the PCB and plate to create a softer, poppier keystroke sound.

Most keyboard cases have empty space inside that creates hollow reverb. Fill that space with closed‑cell foam (or even shelf liner). Cut it to fit the bottom case, leaving cutouts for screw posts and the USB port. The result: a denser, quieter, more premium sound.

Figure: Case foam fitted inside the keyboard bottom housing to reduce hollow sound and improve acoustics.

Where to buy: KBDFans, StupidFish (precut for popular cases), or any craft store foam sheet.

Many switches (especially cheaper or older ones) have a tiny gap between the top and bottom housing. That gap lets the stem wobble and adds plastic‑on‑plastic rattle. Switch films are ultra‑thin polycarbonate or nylon stickers that fill the gap. Install them when you lube switches – they tighten the sound and reduce wobble.

Figure: Switch film fills the tiny gap between the top and bottom housing, reducing stem wobble and plastic rattle.

Note: Not all switches need films. Tight‑fitting switches (like Gateron Ink or JWK) may become too tight.

The plate that holds your switches is a major sound influencer. If your build allows you to swap plates, here’s a quick guide:

Figure: Plate material comparison: Polycarbonate (left) delivers deep thock; brass (right) produces higher clack.

If you want thock, choose PC or POM. Avoid brass and thin aluminum.

1. Start with tape mod – biggest bang for zero dollars.
2. Add PE foam – enhances the richness.
3. Fill the case with case foam – kills hollowness.
4. Film your switches while lubing – tightens everything.
5. Swap the plate only if you still want more depth.

Every keyboard is different. The fun is experimenting to find your perfect sound signature.

Once you’re happy with the sound and feel, the next step is to make sure everything stays reliable – that’s where the troubleshooting flowchart comes in.

Even with careful assembly, things can go wrong. Don’t panic. Most issues have simple fixes. Use this flowchart‑style guide to diagnose and resolve the most common problems.

Start with the symptom, then follow the fix.

Most likely fix: Bent pin (hot‑swap) or cold solder joint (soldered).

• Hot‑swap: Pull the switch. Look at the two metal pins. Are either bent sideways? Straighten gently with tweezers, re‑insert, and test again.
• Soldered: Reheat the joint with your soldering iron. Add a tiny bit of fresh solder. If the joint looks dull or cracked, desolder completely and redo.

Still dead? Swap the switch with a known working one (e.g., from the Esc key). If the problem moves, replace the switch. If the same key stays dead, the PCB socket may be faulty.

Most likely fix: Switch leaf needs bending or replacement.

This is called “chattering.” The metal leaf inside the switch is too sensitive or misaligned.

• Try first: Remove the switch. Use tweezers to gently bend the small copper leaf outward a hair – but this is delicate. Easier: replace the switch entirely.
• Prevention: Avoid using switches with known leaf consistency issues (check reviews before buying).

Most likely fix: Unlubed or poorly seated stabilizer wires.

• Fix: Remove the spacebar keycap. Check that both stabilizer stems move up and down freely. If they feel dry or scratchy, you need to lube the wires (see Step 2 in assembly). In a pinch, apply a tiny dab of dielectric grease with a toothpick.
• Also check: The stabilizer wire may have popped out of its housing. Reseat it firmly.

Most likely fix: Broken PCB trace or bridged solder joints.

This is rare but serious.

• Soldered build: Flip the PCB. Look for any solder bridges (two adjacent pins connected by a blob of solder). Use a desoldering pump to remove the excess.
• Hot‑swap: Inspect the PCB trace – a thin line of copper. If scratched or broken, you may need a jumper wire (advanced repair) or a replacement PCB.
• Quick test: Short the two pads of a dead key with tweezers. If it registers, the switch or socket is the issue. If not, the trace is likely damaged.

Most likely fix: Bad USB cable or corrupted firmware.

• Try another cable – many USB‑C cables are charge‑only, not data.
• Try another USB port – direct motherboard port is best (avoid hubs).
• If still nothing: Reflash the firmware using QMK Toolbox (even if you never changed it). A corrupted EEPROM can make the board appear dead.

Last resort: Check if the PCB has a physical reset button (usually on the back). Hold it while plugging in, then release.

Build problems are almost never permanent. With a little patience, you’ll have a fully working custom keyboard.

Next up: we’ll wrap up with a first‑build shopping list by budget.

Not everyone wants to spend $500 on their first custom keyboard. The good news: you can build a perfectly satisfying board for under $100, or go all‑out on premium components. Below are three complete starter kits – from budget to enthusiast – with parts that are known to work well together.

The LK67 (also sold as the Gamakay LK67) is a complete hot‑swap kit with a knob, foam, and RGB. It’s a 65% layout that fits almost any desk. Pair it with Gateron Yellow switches – they’re pre‑lubed, smooth, and cost around $0.20 per switch. Tai‑Hao keycaps are durable double‑shots that won’t break the bank. Use the stock stabilizers (clip and lube them yourself for free). Total: $100. This board will feel far more expensive than it is.

KBD67 Lite is a gasket‑mount 65% kit with incredible sound for its price. It includes case foam and a polycarbonate plate. Akko CS switches (try the Cream Yellow or Matcha Green) are factory‑lubed and very smooth. NicePBT keycaps offer thick, dye‑subbed PBT plastic – a step up in feel. Swap the stock stabilizers for Durock V2 screw‑ins. Total: $200. This is the most popular first‑build price range for a reason.

Mode Envoy is a machined aluminium 65% board with a beautiful finish and optional plates. Boba U4T switches are tactile, thocky, and beloved by enthusiasts. GMK keycaps are the gold standard for double‑shot ABS – crisp legends and vibrant colours. TX AP stabilizers are wire‑pre‑lubed and extremely tight. Total: $350–400. You don’t need to spend this much, but if you want a heirloom‑quality board, this is the path.

• $80–120: Ideal if you’re unsure about the hobby or want a second board.
• $150–250: Best for most first‑timers – noticeable quality jump without guilt.
• $300+: For those who know they’ll stay in the hobby and want zero compromises.

Once you’ve picked your budget and parts, you’re ready to build. Revisit the assembly steps, keep your troubleshooting guide handy, and enjoy the process.

You’ve moved from curious beginner to someone who can pick parts, avoid compatibility traps, assemble a board, tune its sound, and fix what breaks. That’s a serious skill set.

Every custom keyboard is a reflection of the person who built it. Yours is no different. Whether it thocks, clacks, or purrs, you made it yours.

Got a build question? Drop it in the comments – I read every one and will help you troubleshoot.

Before you start your next build (and you will start another), revisit the Ultimate Keyboard Size Guide to choose your layout first. Size determines everything: case, PCB, plate, even keycap set compatibility. Get that right, and the rest falls into place.

Now go enjoy that board. You earned it. ⌨️

Between 2 and 6 hours. A hot‑swap build with basic assembly takes 2–3 hours. Soldering every switch, adding foam, and lubing stabilisers pushes it to 4–6 hours. Go slow – rushing causes bent pins.

No. Buy a hot‑swap PCB – you just push switches into sockets. Soldering is only required if you choose a non‑hot‑swap board or want to repair something later.

A 60% hot‑swap kit (e.g., LK67, KBD67 Lite, or a pre-assembled test board). Fewer keys means less soldering (or none), simpler case compatibility, and cheaper keycaps. You’ll learn the basics without overwhelming complexity.

No. Check 3‑pin vs 5‑pin. Many hot‑swap PCBs only accept 3‑pin switches. 5‑pin switches have two extra plastic legs – they won’t fit unless you clip them off. Also verify layout support (e.g., 60% PCB with 60% case).

They need lubrication. Factory switches often have inconsistent or no lube. Apply a thin layer of Krytox 205g0 to the stem and housing contact points – the difference is night and day.