Fabric is the lightweight mod loader that lets you run mods in Minecraft, from performance boosters like Sodium to the Iris shader loader. Installing it only takes a few minutes, and once it is set up, adding mods is as simple as dropping files into a folder. There are just a couple of steps people trip over, which this guide walks you through.
This guide covers installing the Fabric loader, adding the Fabric API that most mods need, where your mods actually go, and the gotchas that stop it from working. This applies to the latest 2026 version of Minecraft; always match every file to the version you play.
Quick answer: download the Fabric installer from the official Fabric site, run it, select your Minecraft version, and click Install. A Fabric profile appears in your launcher. Then drop Fabric API and any mods (as .jar files) into your .minecraft/mods folder.
Fabric at a Glance
| Detail | Value |
|---|---|
| What it is | The mod loader that runs Minecraft mods |
| Get it from | The official Fabric site |
| Also need | Fabric API (most mods require it) |
| Mods go in | Your .minecraft/mods folder |
Step 1: Install the Fabric Loader
- Download the Fabric installer from the official Fabric site.
- Close Minecraft and the Minecraft launcher completely (the install fails if either is open).
- Run the installer, make sure your Minecraft version is selected, and click Install.
- Open the Minecraft launcher, and you will see a new Fabric installation in the version list.
One thing that catches people out: you must have launched that Minecraft version at least once before installing Fabric for it. If the install will not work, open that version to the main menu once, close it, and try again.
Step 2: Get the Fabric API
Almost every Fabric mod depends on the Fabric API, a core library mod. Grab it first:
- Download Fabric API from Modrinth (or CurseForge).
- Make sure you pick the file that matches your exact Minecraft version and the Fabric loader.
Skipping Fabric API is the number one reason a freshly installed mod fails to load, so treat it as required.
Step 3: Add Fabric API and Mods to the Mods Folder
Now put your mods where Minecraft can find them:
- In the Minecraft launcher, go to Installations, find the Fabric loader installation, and click the folder icon to open your Minecraft folder. (You can also reach it by pressing Win + R and typing %appdata%.minecraft.)
- Open the mods folder. If there isn’t one, create a folder named exactly mods.
- Drag your mod .jar files (including Fabric API) into that folder.
Heads up on dependencies: some mods need other mods to run. On a mod’s download page, check its related projects or dependencies, and install those too, or the mod will not work.
Step 4: Launch With the Fabric Profile
Open the Minecraft launcher, select the Fabric loader installation from the dropdown, and click Play. Your mods load with the game. You can confirm they are working by checking the Mods menu or looking for the mod’s features in-game.
The Gotchas That Break Fabric
Most failed installs come down to one of these:
- Version mismatch. Fabric, Fabric API, and every mod must target the same Minecraft version. Mixing versions is the most common cause of crashes.
- Launcher left open. Close Minecraft and the launcher before running the installer.
- Version never launched. Play the target version once before installing Fabric for it.
Bonus: Fabric Is the Base for Shaders
Once Fabric is installed, you are one step away from a much better-looking game. Adding the Iris shader loader (and Sodium for performance) on top of Fabric is how you run shaders, and our guide on how to install shaders picks up right where this leaves off. For more performance, our best optimization mods all run on Fabric too.
Frequently Asked Questions
Download the Fabric installer from the official Fabric site, close Minecraft and the launcher, run the installer, select your version, and click Install. A Fabric profile then appears in your launcher.
Yes, for almost every mod. Fabric API is a core library that most Fabric mods depend on, so download it and put it in your mods folder alongside your other mods.
In your .minecraft/mods folder. Open it from the Fabric installation’s folder icon in the launcher, or by typing %appdata%\.minecraft in the Run box, then drag your .jar files in.
Usually because Minecraft or the launcher is still open, or because you have not launched that Minecraft version yet. Close everything, open the target version once, then run the installer again.
Most often a version mismatch or a missing dependency. Make sure the mod matches your Minecraft version and that you installed Fabric API and any other mods it requires.
Yes. The Fabric loader, Fabric API, and the vast majority of Fabric mods are completely free to download.
Fabric is the foundation for almost everything in modded Minecraft, and installing it is genuinely quick once you know the steps. Match your versions, run the installer, and drop your mods in the folder. Next, use it to make the game gorgeous with our how to install shaders guide.
