Safe to Delete

Battle.net Cache & Agent Folders (%ProgramData%\Battle.net)

Quick Answer: Battle.net Agent and Cache folders store launcher data and update patches. Deleting them is safe and resolves Blizzard launcher update stuck errors.

Bottom Line: It is 100% safe to delete the Battle.net Cache and Agent folders. Deleting them will NOT uninstall your games (World of Warcraft, Call of Duty, Overwatch, Diablo) or remove your game saves.


What are the Battle.net Cache & Agent Folders?

Located at C:\ProgramData\Battle.net and C:\ProgramData\Blizzard Entertainment on Windows (or /Users/Shared/Battle.net on macOS), these hidden folders store operational files for the Blizzard Battle.net desktop app.

These folders hold:

  • Battle.net Agent: The background service that checks for game updates and patches.
  • Launcher Caches: Temporary images, patch fragments, and news feed data.

When the Battle.net launcher gets stuck on “Updating Battle.net Agent” or “Initializing…”, corrupt files in these cache folders are almost always the root cause.


Can You Delete Battle.net Cache?

✅ Yes, it is completely safe to delete.

  • Fixes launcher errors: It is the official Blizzard Tech Support step to fix launcher hangs, download loops, and update errors.
  • Auto-rebuilds: Battle.net will create a fresh Agent folder automatically when launched.

How to Safely Clear Battle.net Cache Folders

Method 1: Delete Cache on Windows

  1. Close the Battle.net app completely (right-click Battle.net in system tray > Exit).
  2. Press Ctrl + Shift + Esc to open Task Manager. Ensure Agent.exe or Battle.net Update Agent is not running.
  3. Press Win + R, type %ProgramData%, and press Enter.
  4. Right-click the Battle.net and Blizzard Entertainment folders and click Delete.
  5. Restart Battle.net.

Method 2: Delete Cache on macOS

  1. Open Finder.
  2. Press Cmd + Shift + G, paste /Users/Shared, and press Enter.
  3. Delete the Battle.net folder and empty Trash.

Discussion

Loading authentication...

Related in gaming

Battlefield GPU Shader Cache (Battlefield 2042/cache)

Battlefield stores pre-compiled Frostbite engine GPU shaders. Deleting the cache resolves post-patch stuttering.

Safe to Delete

Call of Duty Warzone Shader Cache (main/shadercache)

Call of Duty Warzone caches compiled DirectX graphics shaders. Resetting shaders in-game or purging cache is safe.

Safe to Delete

Citra Nintendo 3DS Emulator Shader Cache (Citra/shaders)

Citra caches compiled PICA200 3DS graphics pipeline shaders. Clearing shader cache is safe.

Safe to Delete
Back to all files