When an e-bike or electric moped stops shifting, the cause is usually one of two things. Either the shift signal isn't reaching the derailleur, or the derailleur can't move the chain cleanly across the cassette. Both feel identical from the saddle. The fixes don't. Electronic drivetrains fail differently from cable-operated ones, so find out which system you have before touching anything.
Which one is yours? Once you know, most shifting problems fall into a short set of buckets: power, connection, cable tension, cable friction, hanger alignment, or worn drivetrain parts. Work through them in that order. A few checks do need a repair stand, a chain wear indicator, and a derailleur hanger alignment tool.
| System | Common first clue | First checks |
|---|---|---|
| Electronic, such as Di2 or AXS | No movement at all, or delayed shifts | Battery charge, battery contacts, wire seating, pairing |
| Mechanical cable | Some gears work, others hesitate | Cable tension, housing friction, barrel adjuster, limit screws |
| Either system | Grinding, skipping, noisy chain | Chain wear, cassette debris, bent hanger |
Start With Power and Connections on Electronic Shifters
Electronic shifting is great right up until it isn't. A dead coin-cell battery in the shifter can make the whole system look broken even when the main battery reads full, and that sends people hunting for faults that aren't there. Start with the least glamorous check on the list. It's the fastest thing to rule out. On Shimano Di2, charging runs through the junction box or the charging port, and the Shimano Di2 manual calls for a 5.0 V DC adapter rated at 1.0 A or higher. The same manual says to stop charging if the battery hasn't reached a full charge after four hours.
SRAM AXS takes more battery checking, because there are simply more batteries involved. Test both derailleur batteries, plus the CR2032 cells inside the shifters. If every battery shows green and the bike still won't shift, the system may need re-pairing. SRAM's AXS tech tips cover that process. A wash or a wet ride can also leave moisture sitting on the battery contacts. Pull the battery, dry the contacts, and reinstall it before you go chasing deeper electrical faults.
If the derailleur moves but the chain rubs or hesitates, you're not dealing with a dead battery. That's indexing or trim. Di2 systems often trim automatically, so rubbing that never quite goes away usually means the setup needs attention. AXS lets you micro-adjust through the app or the controller. Small changes only, one click at a time.
Mechanical Derailleurs: Cable Tension, Friction, and Hanger Alignment
A cable pulls the chain up toward the bigger cogs. A spring releases it back toward the smaller ones. That split makes mechanical diagnosis easier than it sounds, because the direction of failure points at the cause. A chain that won't climb to a bigger cog usually means the cable is too loose. One that won't drop to a smaller cog points at housing friction or a sticky derailleur instead.
Grit, rust, or a frayed strand inside the housing adds drag, and drag is what kills consistent shifting. Park Tool's rear derailleur adjustment guide notes that friction along the cable prevents consistent movement as it's pulled and released. Swapping in a fresh cable and housing often cures a lazy downshift faster than another evening of barrel adjuster tweaks. Cheap parts. Quick fix.
Thing is, indexing, limit screws, and B-tension are separate jobs. Start with the basics: limit screw settings first, then indexing, then B-screw adjustment. Don't confuse a limit screw problem with a cable tension problem. If the high limit is set too tight, the derailleur may never reach the smallest cog, no matter how carefully you adjust the cable.
A bent derailleur hanger is the great imitator.
Cogs sit close together on 11- and 12-speed cassettes, so even a small bend can make proper indexing impossible. Check the hanger with a real alignment tool such as the Park Tool DAG-2.2 or DAG-3. Park Tool's advanced troubleshooting page explains how to check and repair the hanger. Whatever you do, don't bend it back by hand or with pliers. Aluminum snaps.
One more trap worth naming: cable-pull mismatch. A SRAM 1:1 shifter paired with a Shimano derailleur is a known mismatch, and the annoying part is that the parts bolt together fine. They just never index correctly. No amount of cable adjustment sorts that out. If the bike was assembled from mixed parts, confirm compatibility before adjusting anything.
Check Chain, Cassette, and Debris Before You Adjust
A worn chain skips under load, and no amount of indexing will fix that. Measure it with a chain wear indicator and follow the tool's markings for your chain. Here's where people get tripped up: that 0.8% wear figure quoted all over the place is tied to certain SRAM chains and specific tools, not every drivetrain. SRAM's chain maintenance guidance recommends replacing the chain when wear exceeds the limit on its approved indicator. Some mechanics replace 11- and 12-speed chains earlier than that. The manufacturer's indicator is still the safer guide.
Give the cassette teeth a look while you're in there. Symmetric is what you want, not hooked, not sharp. Electric mopeds pick up road grime around the derailleur pulleys and the cassette, so degrease and brush those areas before you blame the shifter. A clogged pulley can make a perfectly adjusted derailleur feel broken.
E-Bike-Specific Shift Sensors and Diagnostics
Plenty of e-bikes cut motor power for a moment during a shift, and a shift sensor or a controller setting is what makes that happen. When the sensor is misaligned, or damaged, or just unplugged from a rough trail ride, you can get delayed shifts, a clunk, or a surge of power right in the middle of a gear change, and the whole time it feels like the derailleur is at fault even when the derailleur itself is fine. Rule the sensor out before you start turning limit screws.
Not every e-bike has a shift sensor. Behavior varies by brand and model, so check what yours actually does. Your display or app may show error codes, and those are worth reading before anything else. Update firmware only through the manufacturer's instructions. Some systems offer diagnostics through a mobile app or the onboard display. If yours does, use those first.
A Practical Diagnosis Order
Work top to bottom and resist the urge to skip ahead. Each step either finds the fault or rules something out.
- Power off the bike and remove the main battery if the manual says to. Get the rear wheel off the ground.
- Identify whether the drivetrain is electronic or mechanical.
- Electronic: charge and check batteries, contacts, wire seating, and pairing.
- Mechanical: shift one click at a time and note which direction fails.
- Inspect the cable and housing for kinks, rust, fraying, or drag.
- Check hanger alignment with a proper tool if you have one. If you don't, stop and book a shop.
- Check chain wear, cassette teeth, and debris.
- Test ride at low assist and light pedal pressure, shifting one gear at a time. Move to higher load only when shifts are quiet and consistent.
Safety, Model Limits, and When to Stop
Turn the system off before you work near the drivetrain. It takes seconds, and it prevents the worst outcome. An accidental motor engagement can pull a finger, a tool, or a sleeve into the chainring. Use only manufacturer-approved cleaners near electronic components and seals, because harsh chemicals can damage both.
If the bike took a drive-side impact, don't ride it until the hanger and derailleur have been checked. A bent hanger can send the derailleur into the spokes. Internal Di2 wiring repairs and firmware recovery are shop jobs unless you have the correct diagnostic equipment. A shop can test individual components, measure hanger alignment, and check compatibility.
To be honest, most riders never need a replacement derailleur to fix a shifting complaint. The usual culprits are power, cable drag, hanger alignment, or chain wear. One related note while you're already working on the bike: if the battery is damaged, recalled, or overheating, follow the instructions in the recall notice and report the issue through the CPSC micromobility safety center. That's separate from shifting, but it matters.
What to Do Next
Start with the simplest check and work upward. On an electronic system, confirm battery charge and connections first. On a mechanical one, look at cable drag and hanger alignment. Clean the drivetrain, measure chain wear, then test one shift at a time with low assist. If the derailleur still won't move through the full cassette after all of that, stop adjusting and get the hanger checked with a proper tool.