Skip to content
Troubleshooting 10 min read

Steam Workshop Not Downloading? 9 Fixes That Actually Work

Steam Workshop stuck at 0%, queued forever, or refusing to download? Nine fixes in the order worth trying, including the manifest file most guides never mention.

You subscribed to a mod and nothing happened. Or the download sat at 0% and never moved. Or Steam insists the item is installed while the game disagrees. These look like one problem but they are several, and the fixes below are ordered from least disruptive to most — so start at the top and stop as soon as it works.

First: work out which failure you have

Thirty seconds of diagnosis saves a lot of pointless cache clearing. Match your situation to one of these:

  • Nothing happens when you subscribe. No queue entry, no progress. Steam is not registering the subscription, or it thinks the item is already installed. Go to fixes 3 and 5.
  • The download appears but sits at 0%. Steam has queued the transfer and cannot start it. Fixes 2 and 4.
  • The download starts and then stalls partway. Interrupted transfer with leftover partial data. Fixes 2, 4 and 7.
  • Steam says installed, the game shows nothing. The manifest is out of sync — this is fix 5, and it is the single most common cause people never find. If the download definitely completed, the mod may also just need enabling in-game, which is a separate problem covered here.
  • Everything else downloads fine except Workshop items. Not a network fault. Skip straight to fixes 3 and 5.

One useful early test

Subscribe to a small, popular item for a different game. If that downloads instantly, the problem is specific to one game's manifest rather than anything global — which points at fix 5 and lets you skip most of this list.

1. Restart Steam properly

Worth ruling out first because it costs nothing. Closing the Steam window does not close Steam — it keeps running in the system tray. Right-click the tray icon and choose Exit, wait a few seconds, then reopen.

On Windows, check Task Manager for any lingering steam.exe and end it before relaunching. A half-exited client holds the download queue in a state that a fresh start clears.

2. Clear the download cache

This discards Steam's record of in-progress transfers and is the standard first real fix.

  1. Open Steam → Settings
  2. Go to the Downloads section
  3. Click Clear Download Cache
  4. Confirm, and sign back in when prompted

You will be signed out, so have your password ready. Nothing installed is removed — games and completed Workshop items are untouched. Only pending transfer state is discarded.

Try subscribing again once you are back in.

3. Turn off the auto-update schedule limit

This one is badly under-documented and fixes a surprising number of "subscribed but nothing happens" cases. Steam has a setting that restricts automatic updates to a time window, and Workshop content gets deferred along with game patches. If your window is overnight, nothing downloads while you are sitting there waiting.

  1. Open Steam → Settings → Downloads
  2. Find Limit auto-updating schedule
  3. Make sure it is unchecked

Several long threads about mods never appearing end with exactly this. It is a two-click check, so do it early.

4. Clear the stuck download folders

Partially transferred data can wedge the queue. Close Steam entirely, then empty these:

steamapps\downloading\
steamapps\temp\
steamapps\workshop\content\<appid>\

Replace <appid> with the game's Steam app ID — visible in the game's store URL, or in the manifest filenames listed in the next section.

Deleting the contents of downloading and temp is safe: they only ever hold in-flight data. Clearing workshop/content/<appid> removes downloaded Workshop items for that game, so Steam will fetch them again — which is the point, but do not be surprised by the re-download.

Do this with Steam closed

Deleting these while Steam is running can leave the manifest describing files that no longer exist, which creates the exact desync that fix 5 addresses. Close the client first.

5. Delete the workshop manifest file

This is the fix most guides omit, and it resolves the frustrating category where Steam claims an item is installed and the game cannot see it.

Steam keeps a per-game text file recording which Workshop items it believes are installed. If that file and the actual folder contents disagree, Steam trusts the file and concludes there is nothing to do. You wait forever for a download that Steam has already decided is finished.

The file lives here:

C:\Program Files (x86)\Steam\steamapps\workshop\appworkshop_<appid>.acf

On Linux:

~/.steam/steam/steamapps/workshop/appworkshop_<appid>.acf
~/.steam/steam/steamapps/downloading/
~/.steam/steam/steamapps/temp/

Some examples, so you can identify yours:

appworkshop_4000.acf     Garry's Mod
appworkshop_730.acf      Counter-Strike 2
appworkshop_255710.acf   Cities: Skylines
appworkshop_294100.acf   RimWorld
appworkshop_107410.acf   Arma 3
appworkshop_431960.acf   Wallpaper Engine

The procedure:

  1. Close Steam completely
  2. Open steamapps\workshop\
  3. Delete appworkshop_<appid>.acf for the affected game
  4. Start Steam again
  5. Right-click the game → Properties → Installed Files → Verify integrity of game files

Steam rebuilds the manifest from scratch, notices your subscriptions are not actually present, and downloads them.

The surgical version

If you would rather not lose the whole record, the file is plain text and can be edited. Open it in a text editor and find the WorkshopItemsInstalled block. Empty it, leaving the braces:

"WorkshopItemsInstalled"
{
}

Leave WorkshopItemDetails alone — that holds your subscription list. This tells Steam nothing is installed while preserving what you are subscribed to, so it re-downloads without you having to resubscribe to anything.

Back up the file before editing it, in case you need to undo.

6. Verify the game files

A damaged installation can break Workshop handling even when the game launches normally.

  1. Right-click the game in your library
  2. Properties → Installed Files
  3. Verify integrity of game files

Let it finish — on a large game this takes a while. Verification is also what prompts Steam to act on a rebuilt manifest, which is why it is the last step of fix 5.

7. Change your download region

Workshop content comes from the same content servers as games, and an overloaded or misbehaving regional server produces stalls that look like local faults.

  1. Steam → Settings → Downloads
  2. Change Download Region to a different nearby city
  3. Restart Steam and retry

Pick somewhere geographically close rather than the far side of the world — you want a different server, not a slower one. Switch back afterwards if throughput drops.

8. Leave the Steam beta

Beta builds of the client occasionally ship Workshop regressions. If you are opted in and downloads broke recently, opting out is a quick test.

  1. Steam → Settings → Interface (or Account, depending on client version)
  2. Find the Client Beta Participation setting
  3. Set it to No beta chosen
  4. Restart Steam and let it update

9. Check disk space and permissions

Mundane but real. Workshop content lands on the same drive as the game, and some items are far larger than they look — texture packs and map collections run to several gigabytes.

Check:

  • Free space on the drive holding the game library.
  • Write permissions. Steam installed under Program Files can hit permission problems after a Windows update. Running Steam as administrator once will tell you quickly whether that is the cause.
  • Antivirus interference. Some security software inspects or quarantines files mid- download. Add the Steam directory to its exclusions and retry.
  • Drive health. If the library sits on an external or failing drive, write errors show up as stalled downloads.

When none of it works: get the file yourself

Sometimes the client stays broken. A pending Steam issue, a corporate network blocking content ports, or a machine you cannot fully control — and meanwhile you still need the mod.

Workshop items are ordinary files on Steam's content network, and a good share of them publish a direct link. Paste the item's Workshop URL into Steam Workshop Downloader, download the file, and drop it into the game's mod folder. The Steam client is not involved at any point.

Game-specific walkthroughs:

Being straight about the limits: this does not work for every item. Steam only publishes a direct link for items uploaded as a single file, which in our testing was around one in ten across all games — though notably higher for Counter-Strike and Garry's Mod. We measured which items qualify and why. For anything without a link, SteamCMD speaks the same protocol as the Steam client and can fetch it.

Keep a copy once you have one

If a mod matters to your setup, keep the downloaded file. It survives client problems, it will not change under you when the author pushes an update, and it is the only protection against the item being removed from the Workshop later.

Frequently Asked Questions

Why is my Steam Workshop download stuck at 0%?

Usually a stale entry in Steam’s transfer state rather than a network problem. Clearing the download cache and emptying steamapps/downloading resolves most cases. If the item shows as installed but is missing, the workshop manifest file is out of sync and needs deleting.

Where is the Steam workshop manifest file?

At steamapps/workshop/appworkshop_<appid>.acf, where <appid> is the game’s Steam app ID. It is a plain text file recording which Workshop items Steam believes are installed, and it is the cause of a large share of "subscribed but nothing happens" problems.

Does clearing the download cache delete my games or mods?

No. It discards Steam’s in-progress transfer state and signs you out, nothing more. Installed games and completed Workshop items are untouched, so you will need your password but not a reinstall.

Why does Steam say a mod is installed when it is not?

The manifest and the actual files have drifted apart — most often because files under steamapps/workshop were deleted manually, or a transfer was interrupted. Steam trusts the manifest, so it sees no work to do. Deleting the manifest forces a fresh check.

Will unsubscribing and resubscribing fix it?

Sometimes, and it is worth trying for a single item. It is a poor tool for a whole collection, though, because you lose your subscription list and Steam may re-queue everything at once. Fix the manifest first.

Is it a problem with my internet connection?

Rarely, if regular game downloads work normally. Workshop transfers use the same content servers as games, so if games download fine and Workshop items do not, the fault is in Steam’s local state rather than your connection.

Can I download the mod without fixing Steam at all?

Often yes. Many Workshop items publish a direct file link you can fetch in a browser and place in the game’s mod folder, bypassing the client entirely. It works for a good share of items but not all of them, and it is the fastest route when you need the mod today.

Summary

Start with a genuine restart and a download cache clear. If Steam claims the item is already installed, the answer is almost always the appworkshop_<appid>.acf manifest — delete it, verify the game files, and let Steam rebuild. Check the auto-update schedule limit early because it costs two clicks and quietly explains a lot of cases.

If the client will not cooperate at all, fetch the file directly and install it by hand. It is not a universal fallback, but when it applies you have the mod in a minute instead of an evening.

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