Betaflight Board Alignment: Set FC Orientation Right

Betaflight 2026.6 added a wizard that works out flight controller orientation for you, but it only handles mounts in 45° steps. Here is how to set alignment for common mounts, when you still need manual numbers, and how to check the result before you arm.

By the FPV Drone Essentials editors · Build · Published October 12, 2026

The flight controller has no idea how you bolted it into the frame. It assumes its arrow points forward and its components face up. If you turned the board to make wiring easier, angled it 45° on a whoop, or mounted it upside down, you have to tell Betaflight. Board alignment is where you do that.

The Betaflight App 2026.6 changes this job in two ways. The alignment controls now live in a different tab, and there is now a wizard that can work out the orientation by itself. This column covers both, plus the cases the wizard can't handle.

Why a wrong orientation is dangerous

Betaflight's PID controller uses the gyro and accelerometer to work out the quad's attitude and how to correct it. If the board's orientation is set wrong, the controller misreads both the attitude and the corrections it needs. The Betaflight wiki warns that the result is unstable flight and flyaways.

That is why alignment is part of setup and not tuning. You need it right before any props go on.

What changed in Betaflight App 2026.6

Older guides send you to the Configuration tab's Board and Sensor Alignment section. In the 2026.6 app, board alignment is in the Sensors tab. Per the 2026.6 release notes, that tab now has a Board Alignment Wizard. It works out the board's orientation from live accelerometer and gyro data while you move the quad through a few poses.

Some background on versions. The wizard first appeared in Configurator 2026.6.0-RC2 on July 12, 2026, and RC3 on July 23 fixed some problems with it. 2026.6.1 came out August 2, 2026. The current release is 2026.6.2, from September 16, 2026, and firmware 2026.6.2 came out the same day. Betaflight no longer recommends the desktop Configurator. It points users to the browser app at app.betaflight.com, whose version number matches the firmware it supports.

One older piece of advice is now outdated: you no longer need the CLI for a 45° mount because the GUI only allowed 90° steps. The 2026.6.2 manual fields accept 1° steps, and the wizard returns 45° multiples directly. If you prefer typing values in, the CLI settings align_board_roll, align_board_pitch and align_board_yaw still work.

Before you run the wizard

• Calibrate the accelerometer first, with the quad level. The wizard button stays greyed out if the FC has no accelerometer or the accelerometer needs calibrating. A calibration done on a tilted bench can skew the result.
• Check firmware support. In the current app the wizard appears for boards that report MSP API 1.46 or later. The wizard's author describes that as Betaflight 4.5 or newer. The project's own history points to a stricter cutoff at one stage, so updating the firmware is the safer choice anyway.
• Take the props off. You will be picking up and tilting a powered quad.

If this is your first time connecting a new board, start with Betaflight First Setup. The Installing Betaflight chapter of FPV Drone Essentials also covers flashing and the first connection.

Running the wizard

The wizard needs four poses. The app's on-screen prompts are the final word if they differ from this list, and other written guides describe the order slightly differently.

1. Set the quad level on the bench with the camera pointing toward your monitor, away from you.
2. Tip the nose down roughly 45°.
3. Roll the quad right side down roughly 45°.
4. Yaw it clockwise. This last step only double-checks the result. It does not set anything new.

The wizard then gives you a roll, pitch and yaw value. If it isn't confident about what it detected, it warns you. Treat that warning seriously and compare the result with the live attitude display before you apply it.

Common mounts and what to expect

The most important detail about the shipping wizard is in its source code. In 2026.6.2 it rounds every axis to the nearest multiple of 45°, so it can only return 0°, 45°, 90° and so on. For most builds that is exactly what you need.

45° whoop mounts

Oscar Liang points out that 45° mounts are common on micro quads and Tiny Whoops. This used to be the case that sent people to the CLI. Now the wizard handles it directly, and if you would rather type the value, the GUI fields accept it too.

Rotated stacks

Builders often turn a stack 90° or 180° so the USB port or connectors face a convenient side of the frame. These are clean multiples of 45°, so the wizard handles them. The manual yaw field works just as well if you already know the rotation.

Flipped boards, and why order matters

A board that is both flipped and rotated is where manual entry goes wrong most often. Betaflight applies the three angles as yaw-pitch-roll Euler angles, in that order. It yaws first, then pitches the already-yawed frame, then rolls. Set the same three numbers in your head in a different order and you can end up with a different final orientation. The wizard avoids this by measuring the result, not making you work it out. If you set a flipped board by hand, apply the angles in the same order Betaflight does and always verify the result.

When manual offsets still win

The tooltip suggests the wizard does away with manual calculation. That is only true for mounts in 45° steps. The manual Board Alignment fields accept any whole-degree rotation, so these are still manual jobs:

• An AIO rotated by an odd angle like 30°. The wizard would round it to 45°.
• A soft-mounted board that sits a little twisted. A 10 to 20° offset gets rounded away, and you have to enter the remainder yourself.
• A board tilted on purpose, which needs a pitch or roll value the wizard won't produce.

Don't confuse board alignment with sensor alignment. The sensor alignment settings tell Betaflight where external sensors are mounted. They are not for the FC itself.

Confirm on the Setup tab before arming

Whether you used the wizard or typed the numbers, check the result. The Betaflight wiki's method is to move the quad one axis at a time and watch the 3D model on the Setup tab:

1. Props off, quad connected.
2. Tilt the nose down. The model's nose should dip.
3. Roll right. The model should roll right.
4. Yaw the quad, press Reset Z axis, and check that the model's heading matches the real quad.

If any axis moves the wrong way or moves the wrong part of the model, the alignment is wrong. Fix it before going further. Oscar Liang gives the same advice: check the Setup page model before props go on and before the first flight. He also sums up the wizard's appeal: For beginners, it removes one more confusing step.

What board alignment does not fix

Correct orientation does nothing for motor order, motor direction or the props-out setting. Those are separate checks in the Motors tab and mixer, and you still have to do them after alignment. This matters most with a flipped board: the 3D model can look perfect while the motors are still mapped wrong. The Build Order shows where each check fits in a build.

Compass alignment is a separate tool too. In 2026.6.1 the Sensors tab gained a guided magnetometer calibration mode. The 2026.6 release notes also describe a Full Cal (auto-align) tumble that works out the mag's own mounting orientation along with its iron corrections, separately from board alignment. If you are setting up a compass, see Betaflight GPS Rescue Setup: Do You Need a Compass?

For FC mounting choices, including which way the arrow should point and when rotating the stack makes sense, the Flight Controller chapter of FPV Drone Essentials is a good companion to this column.

Sources

• Betaflight 2026.6 Release Notes
• GitHub betaflight-configurator releases
• GitHub PR #5155 (betaflight-configurator)
• betaflight-configurator source, src/js/utils/boardAlignment.js (tag 2026.6.2)
• betaflight-configurator source, locales/en/messages.json (tag 2026.6.2)
• Yaros FPV blog (wizard author)
• Betaflight Wiki: Flight Controller Orientation
• Oscar Liang

Facts checked against the sources above as of October 5, 2026. Drone rules and firmware change; check the current version before you rely on a detail.