Skip to content
Troubleshooting 9 min read

Steam Workshop Mods Not Showing Up In-Game: How to Fix It

Subscribed to a mod but it never appears in-game? This is a different problem from a failed download. Here is how to tell them apart and fix each one.

You subscribed, Steam looked happy about it, and the mod is nowhere in the game. This is a distinct problem from a download that failed, and treating it as one sends people clearing caches for an hour when the actual fix was a checkbox. The first job is working out which side of the line you are on.

Step 1: is the mod actually on your disk?

Everything else depends on this answer, and it takes a minute to get. Open your Steam library folder and look for the item:

C:\Program Files (x86)\Steam\steamapps\workshop\content\<appid>\<workshop_id>\

On Linux:

~/.steam/steam/steamapps/workshop/content/<appid>/<workshop_id>/

<appid> is the game's Steam app ID, visible in its store URL. <workshop_id> is the ?id= number from the mod's Workshop page.

Two outcomes:

  • The folder exists and has files in it. The download worked. Your problem is activation, not transfer β€” go to step 2 and ignore every cache-clearing suggestion you have read.
  • The folder is missing, or exists but is empty. The download did not complete. Step 3 covers the most common cause, and the full download troubleshooting sequence is here.

Some games relocate mods after download

A few games copy Workshop content out of steamapps/workshop into their own directory. Arma 3 uses a !Workshop folder inside the game directory; Cities: Skylines can pull mods into local AppData. If workshop/content looks empty for those games, check the game-specific paths listed further down before concluding the download failed.

Step 2: enable the mod in-game

This is the answer far more often than the internet's cache-clearing advice suggests. In most games, subscribing downloads files and nothing more. Activating them is a separate, explicit action.

Where to look, by game:

  • RimWorld β€” main menu β†’ Mods. Tick the mod and restart when prompted.
  • Cities: Skylines β€” Content Manager β†’ Mods (assets and mods are separate tabs, which catches people out).
  • XCOM 2 β€” the launcher shown before the game starts, not in-game.
  • Arma 3 β€” the Arma launcher's Mods tab; mods must be ticked per launch profile.
  • Stellaris, Hearts of Iron IV, Europa Universalis IV β€” the Paradox launcher, where mods also need adding to a playset.
  • Skyrim / Fallout 4 β€” the in-game Mods menu, or a plugin manager if you use one.
  • Don't Starve Together β€” the Mods menu, with server and client mods enabled separately.

Garry's Mod and Counter-Strike 2 behave differently. Both mount Workshop content automatically with no activation step, so if a GMod addon or CS2 map is missing there, it genuinely is a download or file-location problem rather than an activation one.

Restart the game, not just the menu

Plenty of games only scan for mods at launch. Enabling a mod and returning to the main menu is not enough β€” quit to desktop and start again. Several games say this in small text that nobody reads.

Step 3: fix the out-of-sync manifest

If step 1 showed a missing folder while Steam reports the item as installed, this is your fix. It is also the one that resolves the maddening case where unsubscribing and resubscribing changes nothing.

Steam records which Workshop items it believes are installed in a per-game text file:

steamapps\workshop\appworkshop_<appid>.acf

When that record and the actual folders disagree, Steam believes the file. It concludes the mod is already present, does no work, and reports success. Nothing you do through the Workshop interface will change its mind, because from its point of view there is nothing wrong.

To rebuild it:

  1. Close Steam completely β€” check the system tray
  2. Open steamapps\workshop\
  3. Delete appworkshop_<appid>.acf
  4. Start Steam
  5. Right-click the game β†’ Properties β†’ Installed Files β†’ Verify integrity of game files

Steam rebuilds the record, notices your subscriptions are absent, and downloads them.

Keeping your subscription list

The file is plain text, so you can edit rather than delete. Find the WorkshopItemsInstalled block and empty it, leaving the braces:

"WorkshopItemsInstalled"
{
}

Leave the WorkshopItemDetails block alone β€” that is your subscription list. This tells Steam nothing is installed while keeping what you are subscribed to, so everything re-downloads without you resubscribing to anything. Back the file up first.

This manifest desync is common enough that it turns up in long-running threads for Cities: Skylines, Arma 3, RimWorld, XCOM 2 and others β€” different games, same underlying cause.

Step 4: check dependencies and load order

A different symptom worth separating out: the mod appears in the game's mod list, you have enabled it, and it still does nothing. That is not an installation problem.

Missing dependencies

Many mods are built on a framework mod that must be installed separately. Subscribing to the mod does not always bring its dependencies with it, and a mod missing its framework typically loads silently and does nothing rather than announcing the problem.

Read the mod's Workshop description and its Required Items list. Common examples: Harmony for RimWorld, CBA_A3 for Arma 3, Harmony/Mod Framework for Cities: Skylines.

Load order

Where a game loads mods in sequence, libraries must come before the mods that use them. Most mod managers let you drag entries to reorder. A framework sitting below its dependents will fail in confusing ways, often with errors that point at the wrong mod entirely.

Version mismatch

After a game update, mods built against the old version may be silently deactivated or fail to register. Check the Workshop page for recent activity β€” if the last update predates the game patch and the comments are full of complaints, you are waiting on the author.

Conflicts

Two mods editing the same thing can leave one with no visible effect. The reliable diagnostic is bisection: disable half your mods, test, then narrow down. Tedious, but faster than guessing.

Game-specific gotchas

These account for a large share of "the mod is downloaded but invisible" reports:

  • Cities: Skylines β€” mods and assets live in different tabs of the Content Manager. An asset will never show up in the Mods list, and people conclude it did not install.
  • Arma 3 β€” mods must be enabled in the launcher per profile. Switching profiles appears to lose your mods.
  • Paradox games β€” mods must be added to a playset, and a mod enabled but not in the active playset does nothing.
  • Don't Starve Together β€” client and server mods are separate. A server mod enabled only client-side has no effect in a hosted game.
  • Garry's Mod β€” content mounts automatically, but many addons need assets from another game (Counter-Strike: Source is the usual one). Pink-and-black checkerboard textures mean a missing mount, not a missing addon.
  • CS2 β€” custom maps do not run in official matchmaking modes. They work offline, on a local listen server, and on a dedicated server you control.

Where each game keeps its mods, for checking by hand:

Garry's Mod        steamapps\common\GarrysMod\garrysmod\addons\
Cities: Skylines   %LOCALAPPDATA%\Colossal Order\Cities_Skylines\Addons\Mods\
RimWorld           steamapps\common\RimWorld\Mods\
Skyrim SE          steamapps\common\Skyrim Special Edition\Data\
Arma 3             steamapps\common\Arma 3\!Workshop\
XCOM 2             steamapps\workshop\content\268500\

The subscription cache

One more layer worth knowing about if the manifest fix did not stick. Steam keeps per-account subscription data separately from the per-game manifest:

C:\Program Files (x86)\Steam\userdata\<your_profile_id>\ugc\

Inside are files tracking subscriptions per game. If this has gone stale β€” most likely on a machine with several Steam accounts β€” Steam's idea of what you are subscribed to can be wrong in a way the manifest fix does not touch.

Close Steam and remove the relevant subscription file for the game, then restart. Steam refetches your subscriptions from its servers. Your actual subscriptions live server-side, so this is safe β€” you are only discarding a local cache.

Finding your profile ID

The folder under userdata is a numeric Steam3 ID, not your display name. With one account on the machine there will only be one folder. With several, check the modification timestamps to find the one in current use.

Last resort: install it by hand

If you have rebuilt the manifest, cleared the caches, and the mod still will not arrive, you can skip Steam's involvement entirely: download the file and place it in the game's mod folder yourself.

Paste the item's Workshop URL into Steam Workshop Downloader to get the file, then drop it into the appropriate folder from the list above. Because nothing about this path touches subscriptions or the manifest, none of the sync problems on this page can occur.

Detailed walkthroughs:

The trade-off: a manually installed mod does not auto-update, which for a stable modded save is frequently what you wanted anyway. And not every item offers a direct file β€” here is what determines that.

Frequently Asked Questions

I am subscribed but the mod is not in the game. Where do I start?

Check whether the files exist on disk first, under steamapps/workshop/content/<appid>/<workshop_id>/. If the folder is there with files in it, the download worked and the mod simply is not enabled. If the folder is missing or empty, it is a download problem instead.

Do I have to enable Workshop mods manually?

In most games, yes. Subscribing downloads the files; a separate step activates them. RimWorld, Cities: Skylines, XCOM 2 and Arma 3 all have their own mod managers where the mod must be ticked. Garry’s Mod and Counter-Strike are the exceptions that mount content automatically.

Why does Steam show a mod as installed when the folder is empty?

Steam tracks installed items in appworkshop_<appid>.acf. If that file and the folder contents disagree β€” usually after a manual deletion or an interrupted transfer β€” Steam trusts the file and does no work. Deleting the manifest forces it to check again.

The mod appears in the list but does nothing in-game.

That is normally a dependency or load-order issue rather than an installation one. Many mods need a framework or library mod loaded first. Read the description for required items, install them, and put libraries above the mods that use them.

Why did my mods disappear after a game update?

A game patch can invalidate mods built against the previous version, and mod managers often silently deactivate anything incompatible. Check whether the mod has been updated for the new version; if it has not, you either wait for the author or roll back.

Can I install a Workshop mod without subscribing at all?

Yes for many mods. Download the item as a file and place it in the game’s mod folder directly. That bypasses subscriptions and the manifest entirely, and it also pins the version so an update cannot break your save.

Does unsubscribing and resubscribing help?

For one stubborn mod it is worth a try. For a whole collection it is a bad idea β€” you lose your subscription list and Steam re-queues everything at once. Fix the manifest first; it addresses the underlying cause.

Summary

Check the disk first. If the files are in steamapps/workshop/content/<appid>/<workshop_id>/, this is an activation problem and the fix is in the game's own mod manager β€” not in Steam. If the folder is missing while Steam insists the item is installed, delete appworkshop_<appid>.acf and verify the game files.

Mods that appear in the list but do nothing are almost always missing a dependency or sitting in the wrong load order. And when Steam will not cooperate at all, installing the file by hand sidesteps the entire subscription mechanism.

Ready to download a Workshop item?

Paste any public Steam Workshop URL and get the item details in seconds. Free, no account, no Steam client needed.

Open the Downloader