How do I set up joystick profiles in X-Plane 12?
To set up joystick profiles in X-Plane 12, calibrate your controllers, open Settings > Joystick, choose Active Profile, and save a new profile. Name it for an aircraft or control layout, assign axes and buttons, then select that profile while the intended aircraft is loaded so X-Plane can associate the two.
Setting up an X-Plane 12 joystick profile
- Connect and calibrate every controller. Attach the joystick, yoke, pedals and throttle quadrant you intend to use. Complete our X-Plane 12 joystick calibration procedure before building profiles; a profile cannot correct an axis that Windows or X-Plane is not reading properly.
- Load the intended aircraft. This matters because X-Plane associates the active profile with the loaded aircraft, and add-on-specific commands may not appear until that aircraft is running.
- Open the joystick settings. Go to
Settings > Joystickand confirm that every connected device has its own tab or device entry. - Create a profile before changing assignments. Open
Active Profileand use the option to save a new profile. Starting from an existing working profile is useful, but create the copy first; otherwise, changes will also affect every aircraft using the original profile. - Give it a descriptive name. Names such as
GA single engine,Twin turboprop,Airliner two leverorHelicopterare more useful than an aircraft registration or livery name. - Assign axes and commands. Set pitch, roll, yaw, throttle and any propeller, mixture, condition-lever or toe-brake axes. Map trim, brakes, views, autopilot disconnect and other frequently used commands to buttons and hats.
- Remove conflicting assignments. Set unused physical axes to
None, especially twist grips and spare throttle levers. Two devices assigned to yaw or throttle can make the controls jump, resist movement or return unexpected values. - Select the profile for the aircraft. With the aircraft still loaded, leave the new profile selected under
Active Profile. X-Plane remembers that association. UseManage Profileswhen you need to review, rename, copy or remove profiles and their aircraft associations. - Test from the cockpit. Move every axis through its full range and check the animated controls, engine levers and toe brakes. Confirm that throttle direction, brake direction and any reverse-thrust detents behave correctly before departure.
X-Plane retains profile edits without a separate conventional Save button. Avoid switching profiles halfway through editing unless you have finished checking the assignments.
What does a joystick profile contain?
An X-Plane input profile stores the control layout for the complete set of attached devices, not just one joystick.
| Stored in the control profile | Handled separately |
|---|---|
| Axis assignments and reversals | Graphics, sound and weather settings |
| Button, switch and hat commands | Aircraft state and cockpit configuration |
| Axis response curves and related tuning | Basic device detection and hardware faults |
| Mappings for the connected yoke, pedals and throttles | Plugin configuration outside X-Plane's control system |
This whole-device behaviour catches many users out. A profile called “737 throttle” also contains the assignments for the pedals, yoke and button boxes that were present when it was configured.
Should I create one profile for every aircraft?
Create profiles for distinct control layouts, then share each profile among aircraft that use the same arrangement.
- General aviation singles: one throttle, propeller and mixture arrangement where applicable.
- Twin-engine aircraft: separate left and right engine levers.
- Airliners: appropriate throttle detents, speed-brake controls, flap controls and autopilot commands.
- Helicopters: cyclic, collective and anti-torque assignments without fixed-wing throttle mappings interfering.
A dedicated aircraft profile is justified when an add-on exposes custom commands or uses unusual lever logic. Load that aircraft before assigning those commands; they may be unavailable when another aircraft is active. Different liveries using the same .acf normally share an association, while separate aircraft variants with different .acf files may need to be assigned individually.
Why does X-Plane load the wrong joystick profile?
The usual cause is a missing aircraft association or two aircraft sharing a profile that was later edited.
- Load the affected aircraft, return to
Settings > Joystickand select the intended entry underActive Profile. - If controls changed in several aircraft at once, they share one profile. Copy that profile, rename it, associate the copy with the affected aircraft and edit the copy.
- After installing a separate version or updated copy of an aircraft, check the association again. X-Plane can treat another
.acffile as a different aircraft. - If assignments disappear, reconnect all controllers before launching X-Plane and verify that the expected devices are listed.
- If an axis or button is absent outside X-Plane too, use the Windows joystick test procedure before resetting profiles.
How do I back up X-Plane 12 control profiles?
Close X-Plane, then copy the Output/preferences/control profiles folder from the X-Plane installation to a safe location. Copying the broader Output/preferences folder also preserves related preferences and calibration data, but restoring all of it can reintroduce obsolete settings after a hardware or operating-system change.
Back up the profile folder before deleting preferences during troubleshooting. Recalibrating a controller is quick; rebuilding several aircraft-specific button and axis layouts is not.