Battlenet not downloading often comes from a stuck update agent, a blocked connection, or a write error, and a clean restart plus cache reset clears it.
When Battle.net sits on “initializing,” crawls at 0 B/s, or loops on “waiting,” it feels like nothing is happening. The good news is that most stalls come from a small set of causes: the agent process is wedged, the app can’t write to disk, or your network path is being filtered. This guide walks you through checks so you can get back to installing or patching.
Fast Checks That Clear Most Stalls
Start with these quick wins. They don’t change your system in a lasting way, and they often get downloads moving.
- Pause And Resume The Download — Click the pause button, wait 10 seconds, then resume to force a fresh request to the servers.
- Exit Battle.net Fully — Quit the app, then open Task Manager and end any “Battle.net” or “Agent” process that is still running.
- Restart The PC — A reboot clears locked files and resets background services that can trap the agent.
- Try A Different Region — Open the launcher’s region selector and switch to another region, then switch back once the download starts.
- Check Blizzard Service Status — If there’s an outage or maintenance, the launcher may wait or retry with no clear message.
Battlenet Not Downloading During Updates
If the launcher updates but game downloads won’t start, center on the update agent and its cached state. A half-finished update can keep the app in a loop where it never reaches a stable download session.
Clear The Battle.net Cache Safely
This is the single most common “stuck at 0%” fix. It removes temporary files, not your games.
- Close The Launcher And Agent — Quit Battle.net, then end “Agent.exe” in Task Manager if it stays open.
- Open The Cache Folder — On Windows, press Win+R and type %programdata% to open the ProgramData directory.
- Delete Battle.net Folders — Remove the “Battle.net” and “Blizzard Entertainment” folders inside ProgramData to reset cached config and tokens.
- Reopen The Launcher — Start Battle.net again and sign in when prompted, then retry the download.
Reset The Agent Without Reinstalling Everything
If cache clearing didn’t help, reset the agent’s working folders. This can fix loops on “updating Battle.net Update Agent.”
- Exit Battle.net — Make sure the launcher is closed.
- Delete The Agent Folder — In %programdata%, remove the “Blizzard Entertainment” folder if it reappeared after the last step.
- Run Battle.net As Admin — Right-click the launcher and choose Run as administrator so it can recreate folders cleanly.
Network Blocks That Keep Downloads At 0 B/s
Network problems show up as stalled progress, constant “waiting,” or speed that spikes then drops to zero. You don’t need to change your router settings first. Start with the path between your PC and the launcher’s servers.
Quick Network Resets
- Restart The Router — Power it off for 30 seconds, power it back on, then retry.
- Disable VPN And Proxy — Turn off any VPN app and disable proxy settings in Windows network settings.
- Switch To Ethernet — If you are on Wi-Fi, plug in a cable for a test run to rule out wireless drops.
- Change DNS Servers — Set DNS to a public resolver, then flush DNS cache and try again.
Reset The Windows Network Stack
If downloads stall after sleep or a network switch, resetting the Windows network stack can clear the hang.
- Open An Admin Terminal — Right-click Start, pick Terminal (Admin) or Command Prompt (Admin).
- Run The Reset Commands — Type netsh winsock reset, then netsh int ip reset, then restart the PC.
- Renew The Connection — After reboot, reconnect to Wi-Fi or plug in Ethernet, then retry the download.
Firewall And Security App Checks
Security tools can block the agent while still letting the launcher open. Your goal is to allow Battle.net and the Agent process to talk out, then write files in the install directory.
- Allow Battle.net Through The Firewall — In Windows Defender Firewall, add Battle.net.exe and Agent.exe as allowed apps for private networks.
- Temporarily Disable Web Filtering — If your security suite has “web shield” or “safe browsing,” turn it off for a short test.
- Retry On A Clean Network — If possible, test from a mobile hotspot to see if your home network is filtering the traffic.
Disk And Permission Issues That Stop Install Files
When the launcher can’t write to disk, you may see “waiting,” “initializing,” or a download that starts then freezes at the same percentage each time. These checks center on storage, file locks, and permissions.
One sneaky cause is a “controlled folder access” feature in Windows Security or a third-party anti-ransomware module. It can block new executable writers in ProgramData or in your chosen install folder. If you see repeated permission prompts or the folder stays empty while the launcher says it is downloading, allow Battle.net and Agent in that feature, then retry.
Storage Checks
- Confirm Free Space — Leave extra space beyond the game size to handle patch staging and temporary files.
- Change The Install Location — Point the game to a different drive or folder, then retry to rule out a bad path.
- Run A Disk Scan — Use Windows Error Checking on the drive to catch file system issues that stall large writes.
Permission And Lock Fixes
- Run The Launcher As Admin — This avoids silent permission failures when writing to protected folders.
- Remove Read-Only Flags — Right-click the install folder, open Properties, and clear Read-only if it is set.
- Close Heavy Disk Apps — Pause large file copies, game recording, or backup tools that can hold the drive busy.
Battlenet Not Downloading With Throttle Settings
Some “not downloading” reports are speed-limit settings or background throttles that make progress look frozen. A few in-app settings can also force a pause at login or during patch checks.
Also check login state and sleep. A sign-out/sign-in and keeping the PC awake can stop mid-stream pauses.
- Sign Out And Sign In — Log out, close Battle.net, reopen, then sign back in.
- Keep The PC Awake — Set sleep to Never until the download finishes.
Check Download Throttle And Limits
- Open Download Settings — Go to Settings, then Downloads.
- Turn Off Download Limit — Disable any limit or set it to zero so the launcher can use available bandwidth.
- Disable Background Throttle — Turn off “limit bandwidth when downloading in the background” while testing.
Repair The Game Entry
If a single title refuses to move while other games download, the local install record can be out of sync.
- Select The Game — Choose the game that is stuck.
- Run Scan And Repair — Use the built-in repair option, then retry the update.
- Remove Add-Ons — Disable third-party add-ons that hook network traffic while testing.
Triage Table For Common “Stuck” Screens
This table maps what you see to the first action that tends to work. Keep it open while you test so you don’t bounce between random fixes.
| What You See | Likely Cause | First Fix To Try |
|---|---|---|
| 0 B/s for minutes | Agent wedged or filtered route | Exit app, end Agent, clear cache |
| Stuck on “initializing” | Cached state or disk write delay | Clear ProgramData cache, reboot |
| Loops on update agent | Update folder corrupted | Delete agent folders, run as admin |
| Stops at same percent | Bad install path or file lock | Change install folder, check disk |
| Speed crawls at night only | ISP shaping or Wi-Fi drops | Ethernet test, switch DNS |
Clean Reinstall Steps When Nothing Else Works
If you have tried the cache reset, network checks, and disk checks and the app still won’t download, a clean reinstall clears broken launcher files. This is also the best move when the launcher opens but never shows game tiles correctly.
- Back Up Game Folders — If your games are on a separate drive, copy the install folders so you can relink later.
- Uninstall Battle.net — Use Windows Apps to remove Battle.net.
- Delete Leftover Folders — Remove remaining Battle.net folders in ProgramData and in your user AppData folders.
- Restart The PC — Reboot to release locked files.
- Install The Latest Launcher — Download the current installer from Blizzard’s site and run it as admin.
- Relink Existing Games — Use “Locate the game” or point installs to the saved folders to avoid a full re-download.
After reinstall, start one download and watch the first minute. If speed climbs then stays steady, add back any VPN, security suite features, or bandwidth limits one at a time so you can spot the setting that triggers the stall.
If battlenet not downloading keeps happening on only one network, your router, ISP, or a DNS filter is the common thread. If battlenet not downloading follows you across networks and drives, the launcher install or Windows permissions are the common thread. Work through the checks in order and you’ll land on the cause.
