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
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.
- Open Steam → Settings
- Go to the Downloads section
- Click Clear Download Cache
- 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.
- Open Steam → Settings → Downloads
- Find Limit auto-updating schedule
- 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
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:
- Close Steam completely
- Open
steamapps\workshop\ - Delete
appworkshop_<appid>.acffor the affected game - Start Steam again
- 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.
- Right-click the game in your library
- Properties → Installed Files
- 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.
- Steam → Settings → Downloads
- Change Download Region to a different nearby city
- 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.
- Steam → Settings → Interface (or Account, depending on client version)
- Find the Client Beta Participation setting
- Set it to No beta chosen
- 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 Filescan 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
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