Iris Shaders for Minecraft 26.3 and 26.2: exact Sodium versions and how to install

If you've searched for "iris shaders" or "iris mod minecraft," you've probably landed on pages that assume you already know what Iris is. You don't need to. Iris is the mod that makes shader packs (the same ones OptiFine used to run) work on Fabric and NeoForge, and it's the reason Sodium users don't have to choose between performance and pretty lighting.

This page covers what Iris actually does, how it relates to Sodium (the most-searched confusion in this whole topic), which exact Sodium version each Iris build needs on 26.3 and 26.2, how to install it, which shader packs to pair it with, and how it stacks up against OptiFine.

What Iris actually is

Iris is a client-side mod that adds shader pack support to Minecraft. It reads the same .zip shader packs that OptiFine popularized (ShadersMod format), and renders them through a modern OpenGL pipeline instead of OptiFine's older, more monolithic one.

Iris does not replace your renderer. It sits alongside Sodium, which handles chunk rendering and general performance, and adds a shader pipeline on top. Think of Sodium as the engine and Iris as the thing that lets you swap in a different lighting model without breaking that engine.

It's developed by the same community (IMS/CaffeineMC-adjacent developers) that maintains Sodium, which is why the two stay in lockstep on releases.

Iris and Sodium: how they actually relate

This is the part almost every search in this cluster is really asking about, so here it is directly: Iris requires Sodium. They are not competing options and you cannot meaningfully run one without the other on Fabric.

• Sodium replaces Minecraft's chunk rendering pipeline for a large FPS gain. It has no shader support of its own.
• Iris adds shader pack support on top of Sodium's pipeline. Without Sodium underneath it, Iris has nothing to hook into.
• Sodium is a separate required download. On Modrinth, every Iris build lists one exact Sodium version as a required dependency. The Modrinth App and most launchers install it for you; if you download jars by hand, you need both files in mods.

If you've seen the search "iris sodium" and wondered whether they're rivals: they're not. It's one stack. The only decision you make is whether to enable a shader pack inside Iris's video settings, not whether to install Sodium at all.

For a deeper look at how Sodium's rendering pipeline works and how it compares to alternatives like Embeddium on NeoForge, see the Sodium vs Embeddium comparison.

Which Sodium version works with which Iris

This is the table most people searching "iris and sodium 26.2" actually need. It comes straight from the required-dependency field of each Iris build on Modrinth, checked on 29 September 2026.

• On 26.3, use Iris 1.11.7 with Sodium 0.9.2, on Fabric or NeoForge. A Sodium 0.9.3 alpha for 26.3 is also on Modrinth (20 September); it is a test build, so stay on 0.9.2 unless you are troubleshooting with the Sodium developers. The NeoForge build for 26.3 arrived with 1.11.7 on 30 September; before that, 26.3 shaders meant Fabric only.
• On 26.2, use Iris 1.11.4 with Sodium 0.9.2, on Fabric or NeoForge. If you are still on Iris 1.11.2 with Sodium 0.9.1, that pair works, but updating both together is the simpler fix for most problems.
• Older Minecraft: Iris supports 1.16.5 and higher on Fabric and 1.21.1 and higher on NeoForge. For 26.1.x, the build to grab is Iris 1.11.3 (3 August 2026).

Fixing "incompatible with 1.11.2 or earlier of mod 'iris'"

If Fabric refuses to launch with an error saying a Sodium version is incompatible with "1.11.2 or earlier of mod 'iris'" (or similar wording with another version), your Sodium is newer than your Iris supports. Sodium declares which old Iris builds it breaks, and Fabric enforces it. The fix is to update Iris to the latest build for your Minecraft version from the table above, not to downgrade Sodium. On 26.2 that means Iris 1.11.4; on 26.3, Iris 1.11.7.

How to install Iris on 26.3 or 26.2

1. Install Fabric (or NeoForge) first. If you haven't set up a mod loader before, the Fabric mod install guide walks through the Fabric installer and where mod jars go.
2. Download Iris from the official site or Modrinth. The official source is irisshaders.dev, which links out to Modrinth downloads. Grab the build tagged for your exact Minecraft version and loader: 1.11.6 for 26.3 (Fabric), 1.11.4 for 26.2 (Fabric or NeoForge).
3. Drop the jar into your mods folder, alongside Fabric API (or the NeoForge equivalent) if it isn't already bundled.
4. Add the matching Sodium. Download the Sodium version from the table above (mc26.3-0.9.2 for 26.3, mc26.2-0.9.2 for 26.2) and put it in mods next to Iris. The Modrinth App does this step for you.
5. Launch the game, then open Options > Video Settings > Shader Packs. This menu is added by Iris; if you don't see it, Iris didn't load, check your log for a version mismatch.
6. Drop shader pack .zip files into the shaderpacks folder that Iris creates on first launch (or from the in-game shader menu, which has an "Open Shader Pack Folder" button).

If you're building out a broader mod list rather than just shaders, the Fabric performance mods guide covers what to pair with Sodium and Iris for FPS beyond just the shader pipeline, and the complete performance guide covers settings and JVM tuning on top of that.

How 26.3's renderer change affects shaders

Minecraft 26.3 replaced Improved Transparency with an Order-Independent Transparency renderer, which sits in exactly the part of the pipeline Iris hooks into. Iris shipped a stable 26.3 build on release day, so shader packs run on it; if glass, water or particles look wrong on 26.3, update the shader pack itself. The details are in the OIT explainer, and the rest of the 26.3 mod picture is in Sodium, Iris and Fabric on 26.3.

Which shader packs to run with Iris

Iris runs the same shader packs OptiFine did, but performance and compatibility both tend to be better on Iris. A few starting points:

• Complementary Shaders (Reimagined and Unbound variants) is the most recommended all-rounder for mid-to-high-end hardware. The Complementary Shaders review breaks down which variant fits your setup.
• If your hardware is on the lower end, jumping straight to Complementary is a mistake. The best shaders for low-end PCs guide covers lighter packs (Sildur's Enhanced Default, Super Duper Vanilla, Potato Shaders) that are built for GTX 1050-class GPUs and integrated graphics, and it's written specifically around the Iris + Sodium stack.
• BSL Shaders is another common pick with a similar performance profile to Complementary.

Whatever pack you choose, the shadow resolution and shadow distance settings inside the shader pack's own menu have the biggest effect on FPS. Both linked guides above cover tuning those in more detail.

Iris vs OptiFine

The short version: if your priority is FPS and shader support together, Iris + Sodium is the stronger technical choice on Fabric and NeoForge. OptiFine still has a broader grab-bag of cosmetic features (connected textures, custom item textures, a built-in zoom key) that some players prefer, and it remains the default on Forge for players who haven't moved to NeoForge. If you're already committed to a Fabric or NeoForge modpack, Iris is the natural fit; you don't install both.

FAQ

Do I need Sodium to use Iris?

Yes. Iris depends on Sodium's rendering pipeline, and every Iris build on Modrinth lists one exact Sodium version as a required dependency. The Modrinth App installs it automatically; by hand, you download both. On 26.3 that is Iris 1.11.6 with Sodium 0.9.2, on 26.2 Iris 1.11.4 with Sodium 0.9.2.

What Sodium version is compatible with Iris 1.11.2?

Sodium mc26.2-0.9.1, on Minecraft 26.2. But Iris 1.11.2 is no longer the latest 26.2 build: Iris 1.11.4 with Sodium mc26.2-0.9.2 is, and updating both is the easiest fix if you hit a version conflict.

Is Iris updated for 26.3?

Yes. Iris shipped a stable 26.3 build on release day (1.11.6, 15 September 2026), and the current one is 1.11.7 (30 September), for both Fabric and NeoForge. It requires Sodium mc26.3-0.9.2.

Is Iris a mod or a shader pack?

Iris is the mod. It doesn't add any lighting or graphics changes by itself; it's a compatibility and rendering layer that lets separately-downloaded shader packs (like Complementary or BSL) run in Minecraft. You install Iris once, then add shader packs to the shaderpacks folder as many times as you like.

Where do I download Iris?

The official source is irisshaders.dev, which links to the current Modrinth builds. Always match the download to your exact Minecraft version and mod loader (Fabric or NeoForge).

Does Iris work with Forge?

Not directly. Iris supports Fabric (from Minecraft 1.16.5 onward) and NeoForge (from 1.21.1 onward). If you're on original Forge, OptiFine remains the shader option, or the Oculus fork of Iris on some older NeoForge/Forge transitional setups.

Why won't my shader pack load in Iris?

The most common causes are a Minecraft-version mismatch between Iris and your game, a Sodium version that doesn't match what your Iris build expects, or a shader pack that hasn't been updated for the current Minecraft version. Check the shader pack's own Modrinth page for which Minecraft versions it lists as supported.

Can I use Iris without any shader pack enabled?

Yes. With no shader pack selected in the Shader Packs menu, Iris is effectively inactive and you get Sodium's normal vanilla-plus rendering. There's no downside to having Iris installed and simply not turning a shader pack on.