Steam Workshop Mods Not Downloading or Showing Up? How to Fix Subscribed Items

If a Steam Workshop mod is not downloading, close the game first, because Workshop items often will not install fully while it is running. Then check your Downloads page, unsubscribe and resubscribe to the item, and restart Steam. Valve's documentation says that verifying a game's files also triggers Workshop items to download, so that is a reliable next step. If the mod downloads but does not appear in the game, the problem is usually a game setting, an out-of-date mod, or a missing dependency.

Workshop is meant to be the easy way of modding: click a button and you are done. Most of the time it is. When it is not, there is usually very little information about why, and a mod simply sits at zero bytes or never shows up. It helps to understand that "subscribing" and "installing" are separate events, and that the mod still has to be loaded by the game. A failure at each of those stages looks different and has its own solution. This guide works through all of them and covers how to protect your saves while you experiment.

Key facts

• Valve's documentation says that Workshop item downloads are executed by the Steam client and happen automatically.
• Newly subscribed items download and install in the background, and this can happen after the game launches, so a game may start before new content is ready.
• Valve says the Verify Integrity feature also causes Workshop items to be downloaded.
• You need to own a game to subscribe to and download its Workshop items.
• How a game uses Workshop content is up to the developer, so fixes vary from game to game.
• Community reports suggest that unsubscribing, restarting Steam and resubscribing is the most dependable way of forcing a download.
• Game updates are a very common reason for mods breaking, even when they were previously working.

How Workshop downloads actually work

When you click Subscribe, Steam adds the item to your account's list for that game. You have not downloaded anything yet. The Steam client then fetches the item, normally in the background, and places it in a folder for Workshop content. Finally, the game reads that folder and decides whether, and how, to use it.

So there are three separate stages to think about:

1. Subscription. Your account records that you want the item.
2. Download. Steam gets the files and writes them to your drive.
3. Loading. The game finds the mod and enables it.

Valve's Steamworks documentation for developers confirms the first two parts: item downloads are carried out by the Steam client and happen automatically. Newly subscribed items download and install in the background after the game launches. That is the reason a game can open without a mod you have only just subscribed to, and why the mod often turns up the next time you launch.

Knowing which stage has failed is more useful than trying random fixes. Use this table to figure it out.

First steps for any Workshop problem

Close the game completely. Items may not finish installing while a game is running. Valve's documentation describes content downloading in the background, and many players report things moving only once the game has been closed.

Open your Downloads page in Steam. Look at whether the game has queued content. If you see a Workshop item waiting, click to prioritize it or resume it.

Check your subscribed list. Go to the game's Workshop page, open the Browse menu, and choose Subscribed Items. Confirm that the mod is really listed there.

Make sure you own the game on this account. You have to have purchased a game to subscribe to and download its Workshop content. If you are signed in on another account or accessing the game through a family share, take a moment to confirm the access you have.

Restart Steam and then your PC. Fully exit Steam from the system tray and open it again. Restarting can clear a stuck state.

Forcing a download

If the item has not come through, try these in order.

Unsubscribe and resubscribe. Open the mod's page and click Subscribed to unsubscribe. Restart Steam. Open the page again and subscribe. Community guides on Steam regard this as the most dependable way of forcing a fresh download, although some players report that it does not always work the first time.

Verify the game's files. Open the game's Properties, go to Installed Files and verify integrity. Valve's documentation specifically says that this will cause Workshop items to be downloaded. As with all verification, it is normal for a small number of files to report as failing, as Valve explains that those are local configuration files.

Clear the download cache. Go to Settings > Downloads and clear the download cache. Valve says this will not affect installed games, but that you will have to sign in again.

Change your download region. Workshop content comes through Steam's distribution system, so a change of region can help when a server is having problems. It is under Settings > Downloads.

Check for free space. Workshop items are stored in your Steam library, usually on the same drive as the game. Some mods can be many gigabytes in size. A full drive will silently block them.

Why a mod shows 0 bytes or never starts

A Workshop item that is stuck at 0 bytes usually means that the download never properly began. Here are common reasons:

• The game is still running, or a process from it has not closed.
• Another large download is in front of it in the queue.
• A previous attempt left a bad partial download behind.
• Your antivirus is interfering with the Workshop folder.
• The item has been removed or hidden by its author, or is restricted in some way.
• Steam is having a server problem. Check the game's community hub to find out if other people are reporting the same issue.

If the item itself might be the problem, try subscribing to a different and popular mod for the same game. If that one downloads without any trouble, the issue is with the specific item, and it may be worth checking its comments. Authors and other users often report problems there.

Deleting a broken partial download

If a Workshop item is stuck, clearing its local folder can force a clean download. It is a little more technical, but straightforward enough if you follow these steps.

1. Exit Steam.
2. Go to your Steam library, then to steamapps\workshop\content.
3. Find the folder with the game's App ID, which is the number in its store page address.
4. Inside, locate the folder with the mod's Workshop ID. That number is in the address of the mod's page.
5. Delete only that specific folder. Do not delete the entire workshop folder unless you are prepared to download every mod again.
6. Open Steam and allow the item to download again. Resubscribe to it if necessary.

Similar temporary data can appear in steamapps\workshop\downloads. Clearing a stuck item there can also help. Only do this with Steam closed.

A mod downloaded, but it does not show up in the game

If the files are there but the mod is nowhere to be seen, then the download has worked and the problem lies with the game.

Enable it in the game's menu. Most games have a Mods or Content menu where you have to turn items on. Being subscribed does not necessarily mean that it is enabled. Some games handle this automatically, whereas others do not.

Check the game version. A mod built for an older version may not appear or may be flagged as incompatible. Look at the "last updated" date on the Workshop page and compare it to the date of the game's most recent big update.

Look for dependencies. Workshop pages often list "Required items". A mod may be invisible or fail silently if another item is missing. Steam usually prompts you about these at subscription time, but it is worth double-checking.

Confirm that you are launching the right version. If the game has a beta branch, a separate launcher, or several editions, the mod might be for a different one.

Check the mod's type. Some items, such as maps or scenarios, appear in specific menus only, and not in your main mods list.

Try a new game or save. Some mods only apply to new saves. The mod page will usually say so.

Mods crashing the game or making it unstable

If the game crashes after you have subscribed to mods, use a process of elimination rather than guessing.

Doing this by halves is much quicker than testing each one. With 40 mods you can identify a single problem mod in about six test launches rather than 40.

Remember these things while you are doing it:

• Load order matters in many games. If one mod needs to override another, placing them in the wrong order can cause crashes. Check the mod's description for instructions.
• Removing a mod in the middle of a playthrough can break a save. That is especially true of mods that add items or characters. Back up your save before making changes.
• Patches often break mods. If everything stopped working just after a game update, this is very likely the reason. Some games allow you to select an earlier game version through the Betas tab in the game's Properties.

How to protect your saves when using mods

Save data is the thing that you cannot redownload, so make a copy of it before making any substantial changes to your mod list. Our Steam Cloud and save backup guide shows you where saves are usually kept.

For games with Steam Cloud, a corrupted modded save can sync across all of your devices just as faithfully as a good one. If you are testing something risky, consider turning off cloud sync for that game for the duration, and then turning it on again later.

Stopping a mod from updating

Workshop items update automatically, which can break a carefully tuned setup. Steam does not give you a universal "freeze this mod" option for each item, but you have some options.

• Some games have their own mod managers that can lock versions.
• Copying a mod to the game's local mods folder is supported by some games, although it depends entirely on the game and on the mod author's permission.
• If you are about to start a long playthrough, you could check the update behavior of the game itself in Properties > Updates.

Check your game's community before you try to do this, as an unusual setup can create unexpected problems.

Steam Workshop problems on Steam Deck and Linux

Workshop items work on a Steam Deck, but some games store their mods differently when they run through Proton. If a mod seems not to work:

• Check that the game is using the Proton version recommended by its community.
• Look at the game's page on ProtonDB, a community site that collects player reports.
• Check your available storage, since Deck storage fills up quickly. Our Steam Deck storage guide explains how to handle that.
• Close the game completely, since the Deck may suspend it rather than quit. Use the option to exit the game.

Are Steam Workshop mods safe?

Workshop is much safer than random mod sites, but it is not risk-free. Authors can upload all sorts of things, and some game engines let mods run scripts. The following habits will reduce your risk.

Be particularly cautious with any mod page that sends you to an external site for a "required" file. Anything that promises free in-game currency, skins or gift cards is almost certainly a scam. Our Steam account scam guide covers these tricks, and it is worth reading if you trade or mod frequently.

When Workshop content is not the issue

Not every problem with a modded game comes from the Workshop. If the game fails to start even after you have disabled all of your mods, turn to our guide to Steam games that will not launch. If the download stops with an error, our disk write error guide should help.

If only one game has this trouble and all of the usual steps have failed, ask in that game's community hub. Developers decide how their games use Workshop content, and experienced players of that specific game often know the exact fix. When you post, include:

• The game's version.
• A list of your mods, or a link to a Workshop collection.
• What happens and any error message.
• What you have already tried.

Using collections

If you want to set up a large mod list, Workshop Collections are useful. A collection groups many items together, and you can subscribe to all of them with one click. That brings a few things to be aware of.

• Large collections can take a long time to download, and they might stall partway through.
• Items in collections can go out of date or be removed by their authors.
• Subscribing to a large collection can cause conflicts, so check the comments for a recent "this still works" note.
• If you want a stable list, you may want to create your own collection, so that you know exactly what you have included.

Some older community guides mention limits on how many Workshop items certain games can handle. This depends on the game. If you run into trouble only after subscribing to a very large number of items, try reducing the list to see if that resolves it.

Fixing mod mismatches when you play with friends

Multiplayer adds one more thing that can go wrong. In many modded games, everyone in a session has to be running the same mods in matching versions, and a single difference can stop a friend from joining or cause strange desyncs after they connect.

Because Workshop items update on their own, two friends who both subscribed last month can quietly end up on different versions. If someone gets a "version mismatch" or "missing content" message, try this routine:

1. Have every player close the game completely.
2. Let each player's Steam finish any queued Workshop updates on the Downloads page.
3. Compare mod lists, ideally by sharing one Workshop collection that the whole group subscribes to.
4. Have the player with the problem unsubscribe from and resubscribe to the mod named in the message.
5. Relaunch, with the host starting first.

A shared collection is the simplest way of keeping a group in line, because everybody works from the same list, and adding a mod means changing it in just one place. Agree on changes before a session instead of during one, and let the host test any new addition first.

Paying for your next modded favorite

Many of the best-modded games on Steam regularly go on deep discount during seasonal sales, so plan purchases around Steam's sale dates. You might also find it helps to understand what you can buy with Steam Wallet credit before you top up.

For a slower, no-cost option, you can join XPReward and complete offers for points that go toward Steam gift cards. Bear in mind that the minimum card is $25 for 3,600 points, and that the offers available depend on your location, so this is a way of getting there gradually.

Frequently asked questions

Why are my Steam Workshop mods not downloading?

Often the game is still running, a queue is blocking the item, or a partial download has gone wrong. Close the game, check the Downloads page, then unsubscribe, restart Steam and resubscribe. Verifying the game files also triggers Workshop downloads, according to Valve's documentation.

How do I force Steam Workshop to download?

Close the game, unsubscribe from the item, restart Steam and subscribe again. If that fails, verify the game's files, because Valve says this causes Workshop items to download. You can also clear the download cache or change your download region.

Why does my Workshop mod say 0 bytes?

Usually the download has not actually started. Close the game fully, check that you have enough free space and look at your antivirus. Removing that item's folder in steamapps\workshop\content with Steam closed can force a clean download.

Why are my subscribed mods not showing up in the game?

The files may have downloaded successfully, but the game has not enabled them. Check the game's mod menu, confirm that the mod matches the current game version, and look for required items listed on the mod's Workshop page.

Do I need to own the game to use Workshop mods?

Yes. You need to own a game to subscribe to and download its Workshop items. If you use a game via a family share or another account, confirm which account is signed in and what it can access.

Can Steam Workshop mods break my saves?

Yes, particularly if you remove a mod in the middle of a playthrough or when a mod changes after an update. Copy your save folder before making changes, and use a separate save slot when you are testing a new mod list.

How do I find which mod is crashing my game?

Disable all mods and confirm the game runs. Enable half of them and test. Keep halving the group that causes the crash until you are left with one. This is much faster than testing each mod individually.

Are Steam Workshop mods safe to use?

They are generally safer than random download sites, but check ratings, comments and the author's activity. Avoid any mod that sends you to an external download or promises free currency, skins or gift cards.

Sources

• Steamworks Documentation: Steam Workshop Implementation Guide, for how Workshop downloads work and the Verify Integrity behavior.
• Steam Community guide: Workshop item not working FAQ, a community source for common fixes.
• Steam Community guide: Steam Workshop download issues, a community source for forcing downloads.
• Steam Support: Verify Integrity of Game Files, for verification behavior.

Valve publishes no single Workshop troubleshooting page, so some of the steps here come from community guides. Checked on 8 November 2026.