Your quad holds angle perfectly in calm air but wobbles violently after a roll. That is an I-term problem — not P, not D. The I-term accumulates error over time to hold attitude. When it accumulates too fast or too slow, the quad either overshoots and oscillates or drifts lazily back to level. Tuning it right is the difference between locked-in flight and a quad that fights you on every maneuver.
Step-by-Step I-Term Tuning
1. Understand What I-Term Actually Does
P-term reacts to current error. D-term predicts future error. I-term corrects persistent error — the kind that accumulates when wind pushes your quad and P alone cannot hold the angle.
When you pitch forward and release the stick, P-term returns the quad to level, D-term damps the bounce, and I-term holds the final angle against external forces. If I-term is too low, the quad slowly drifts off-angle in wind. If I-term is too high, it overshoots the target and oscillates back — slowly, at 5-15Hz, compared to P-term oscillations at 50-100Hz.
I-term oscillations are distinctive: slow, lazy wobbles of the whole frame, especially after sharp stick inputs. They are most visible on roll/pitch recovery and on yaw stops.
2. I-Term Rotation: The Default-Off Setting That Fixes Roll Oscillations
I-term rotation is a Betaflight feature that rotates the accumulated I-term vector to match the quad’s current attitude. Without it, when you roll 360°, the I-term built up on the original pitch axis is now pointing the wrong direction. The quad has to unwind stale I-term and rebuild it — causing a wobble at the end of every roll.
Turn I-term rotation on. It is in the PID Tuning tab, under the “I Term” section. The default is Off. Every quad flying Betaflight 4.3+ should have it enabled. There is no downside — it eliminates roll-wobble and has zero effect on hover stability.
3. Anti-Gravity Gain: Compensate for Throttle-Induced I-Term Lag
When you punch the throttle, the quad accelerates upward quickly. The I-term was set for 1G of hover. Under 4G of acceleration, the P-term has to work harder, and I-term lags behind because the error changes faster than it can accumulate. Anti-gravity boosts I-term gain proportionally to throttle position to compensate.
| Anti-Gravity Gain | Effect on Punch-Outs | Effect on Propwash |
|---|---|---|
| Off (1.0) | Quad pitches back, needs stick correction | More visible propwash bounce |
| 3.0-3.5 | Minimal pitch-back on full throttle | Propwash bounce reduced |
| 5.0-6.0 | Flat punch-outs, no correction needed | Minimal propwash |
| 8.0+ | Quad starts to feel stiff, overshoot on sharp stops | Propwash gone, but bounce on rolls |
Start at 3.5 and do a full-throttle punch-out in angle mode. If the quad pitches backward, increase by 0.5. When punch-outs are flat with no stick correction, you are at the right value. Most 5-inch builds land between 3.5 and 5.5.
4. Yaw I-Term: The Most Overlooked Tuning Parameter
Yaw I-term behavior is fundamentally different from roll/pitch. Yaw uses differential motor torque, which is far weaker than thrust vectoring. This means yaw I-term needs to be more aggressive to hold heading, but too much creates a distinctive slow oscillation that most pilots misdiagnose as a P-term issue.
| Yaw I-Term | Behavior | Symptom |
|---|---|---|
| Too low (below 60) | Heading drifts during punch-outs | Quad slowly yaws left/right at full throttle |
| Default (80-100) | Generally stable | Fine for most builds |
| Slightly high (110-130) | Crisp yaw stops | May overshoot on 7-inch builds |
| Too high (140+) | Slow yaw oscillation after sharp yaw inputs | Tail wag at 3-8Hz |
The key insight: yaw I-term should be set just high enough that heading does not drift during a full-throttle climb. Any higher and the overshoot on yaw stops creates a wag that ruins footage. Test by climbing straight up at full throttle in angle mode — if the nose turns by itself, add 5 to yaw I-term. Repeat until it holds heading. Then add 5 more as margin and stop.
5. I-Term Relax: Prevent Wind-Up During Acro
I-term relax reduces I-term accumulation during fast stick movements, preventing the classic bounce-back after a sharp roll or flip.
| I-Term Relax Setting | Cutoff (Hz) | Effect |
|---|---|---|
| Off | N/A | I-term accumulates during all maneuvers — bounce-back on flips |
| Low (default, 15) | 15Hz | Reduces bounce, minimal effect on wind handling |
| Medium (10) | 10Hz | Good balance for freestyle |
| High (5) | 5Hz | Maximum bounce prevention, slightly looser in wind |
Set I-term relax cutoff to 10-15Hz for freestyle. For racing, drop to 5Hz to eliminate bounce-back entirely — you are not fighting wind on a race course. For long-range cruising, leave at default 15Hz — wind handling matters more than bounce-back on a cruiser.
I-Term Tuning Parameters at a Glance
| Parameter | Starting Value | Adjustment Direction | Symptom of Too High |
|---|---|---|---|
| Roll I | 85-95 | Increase if quad drifts in wind | Slow roll wobble after sharp input |
| Pitch I | 90-100 | Increase if nose rises on punch-out | Slow pitch bob at hover |
| Yaw I | 80-90 | Increase if heading drifts on climb | Slow yaw wag after stops |
| Anti-Gravity | 3.5 | Increase if quad pitches back on throttle | Stiff/bouncy feel on rolls |
| I-Term Relax | 15 (default) | Decrease for freestyle, increase for cinematic | Looser feel in wind |
| I-Term Rotation | On | Always enable | No downside |
Common Mistakes & How to Avoid Them
Mistake 1: Cranking I-term to fix propwash instead of tuning P and D first.
Consequence: High I-term masks propwash but creates slow oscillations that are harder to diagnose because they happen 2-3 seconds after the maneuver. You mistake I-term oscillation for a P-term problem and crank P up, making everything worse. Fix: Tune P and D to handle propwash first. Only increase I-term if the quad drifts off-angle in sustained wind — not to patch propwash. Anti-gravity gain is the correct tool for propwash reduction without touching base I-term.
Mistake 2: Never enabling I-term rotation.
Consequence: Every roll ends with a wobble as stale I-term unwinds. The quad never feels truly locked in. Fix: Enable I-term rotation. It has been available since Betaflight 4.3 and there is no reason to leave it off except on ancient 2-inch whoops with F411 processors that cannot run BF 4.3+.
Mistake 3: Setting yaw I-term to match roll/pitch values.
Consequence: Yaw has different physics — differential torque instead of thrust vectoring. The same I-term value that works on pitch produces yaw overshoot and wag. Fix: Yaw I-term should be 10-20 points lower than roll/pitch. It needs less because yaw does not fight gravity; it only fights rotational inertia.
Mistake 4: I-term relax set to Off on a racing build.
Consequence: Full-rate snap rolls produce a violent bounce-back as the accumulated I-term unwinds. The quad overshoots the target angle by 10-15° and takes half a second to recover — enough to miss a gate. Fix: I-term relax at 5-8Hz for racing. You sacrifice some wind-holding for crisp flips and zero bounce-back.
⚠️ Regulatory Notice: The flight recommendations in this article should be followed in accordance with the latest 2026 drone regulations in your country or region. Always verify local laws regarding flight altitude, no-fly zones, remote ID requirements, and registration before flying. Regulations vary significantly between the FAA (US), EASA (EU), CAA (UK), CAAC (China), and other authorities.
For the full PID tuning picture, see our Betaflight PID tuning guide — I-term is only one piece of the PID loop. Our Betaflight RPM filtering guide covers the filter setup that makes I-term tuning possible — without clean gyro data, I-term chases noise instead of error.
For a flight controller that handles aggressive I-term settings without noise artifacts, the SpeedyBee F405 V4 is my pick. Its BMI270 gyro has lower noise density than older MPU6000 units, which means I-term can accumulate cleanly without amplifying gyro noise.