---
title: "How to Add Mods to a Prism Launcher Instance | Prism Launcher"
description: "Add mods to a Prism Launcher instance: match the loader and game version, add one mod at a time and test."
canonical: https://prismlauncher.ink/howto/add-mods-to-an-instance
updated: 2026-10-17
---

# How to add mods to a Prism Launcher instance

Add mods to a Prism Launcher instance: match the loader and game version, add one mod at a time and test.

## Facts (2026-10-17)

- **Price:** Free and open source
- **Platform:** Windows, macOS, Linux
- **Purpose:** Minecraft instance and modpack launcher
- **Download:** Installers and portable builds

## Adding a mod

Confirm the instance uses the mod loader the mod needs, match the Minecraft version exactly, then add one mod and launch before adding more.

## FAQ

### Why does an instance crash after adding a mod?

Usually a version or loader mismatch, or a missing dependency. Remove the last mod added and re-check its requirements.

## Related

- [Prism Launcher Instance Management](https://prismlauncher.ink/instances)
- [How to install a modpack in Prism Launcher](https://prismlauncher.ink/howto/install-a-modpack)
- [Prism Launcher Windows Setup & Installation](https://prismlauncher.ink/setup)

## Download

Free and open source: [Download Prism Launcher](https://prismlauncher.ink/download)

Markdown mirror: https://prismlauncher.ink/howto/add-mods-to-an-instance.md