# How To Install Mods on Your Squad Server (/docs/squad/install-mods)





import { Step, Steps } from 'fumadocs-ui/components/steps';

Squad supports Steam Workshop mods that can add new maps, factions, vehicles, and gameplay modifications. Every XGamingServer Squad server has a built-in **Mods** tab with a full Steam Workshop browser, so you can search and install mods in one click — no Workshop IDs to copy, no config editing.

Install Mods from the Panel (Recommended) [#install-mods-from-the-panel-recommended]

<Steps>
  <Step>
    Open the Mods tab [#open-the-mods-tab]

    Log in to the [XGamingServer panel](https://panel.xgamingserver.com), select your Squad server, and open **Mods** under **CONFIG** in the sidebar.
  </Step>

  <Step>
    Search the Steam Workshop [#search-the-steam-workshop]

    On the **Steam Workshop** tab, search by name or sort by **Trending**. Each result shows its download count, last-updated date, and description.
  </Step>

  <Step>
    Click Install [#click-install]

    Hit **INSTALL** on any mod. It's queued and downloaded via SteamCMD into `SquadGame/Plugins/Mods` on the next server restart — any required dependencies are added automatically.
  </Step>

  <Step>
    Restart to apply [#restart-to-apply]

    Go to **Console** and restart. Check the **Installed Mods** tab any time to see what's running or to remove a mod.
  </Step>
</Steps>

<img alt="The Steam Workshop mod browser in the XGamingServer Squad control panel, showing mod cards with download counts and one-click Install buttons" src={__img0} placeholder="blur" />

> ⚠️ **Warning:** Players must also subscribe to the same mods on the Steam Workshop to connect. Mods with mismatched versions will prevent players from joining.

> 💡 **Tip:** After a mod is installed, add its layers to your **Layer Rotation** (`MapRotation.cfg`) using the mod's layer names — otherwise the new maps won't appear in rotation.

Manual Method (Workshop IDs) [#manual-method-workshop-ids]

Prefer to manage mods by ID? You can still add them on the **Startup** page:

1. Copy each mod's **Workshop ID** from its [Steam Workshop](https://steamcommunity.com/app/393380/workshop/) URL.
2. Open **Startup** in the sidebar and enter the IDs in the **Workshop Mod IDs** field.
3. Restart from **Console** — the mods download automatically during startup.

> 📝 **Note:** Mod downloads can take significant time depending on size. Watch the console for download progress.