WebStorm High Memory Usage: Increase Heap Size

Share
Workaround available Windows, macOS, Linux Updated November 14, 2026How we research

Quick answer

If WebStorm warns about low memory or lags, raise the heap in Help | Change Memory Settings (the -Xmx JVM option) and restart.

Most likely fix: Change memory settings

How to fix it

Try these in order — the most common fix is first.

  1. 1. Change memory settings

    1. Go to Help | Change Memory Settings
    2. Set the amount of memory to allocate
    3. Click Save and Restart
    Did this fix it?
  2. 2. Edit custom VM options

    1. Go to Help | Edit Custom VM Options (Configure | Edit Custom VM Options on the Welcome screen)
    2. Add one option per line, for example -Xmx2048m
    3. Do not edit the default .vmoptions files; updates replace them
    Did this fix it?
  3. 3. Watch usage

    1. Right-click the status bar and select Memory Indicator
    2. Use -XX:NewRatio 1 if you often open new files or switch projects
    Did this fix it?

Symptoms

Low memory warning (free heap under 5% after garbage collection), freezes, and stutter on large projects.

Why it happens

  • Heap limit too low for the project size
  • Many files open or frequent project switching
  • Large files opened in the editor

This guide also covers

  • webstorm increase memory
  • webstorm high memory usage
  • webstorm xmx
  • webstorm out of memory

Still not working?

If WebStorm keeps failing, you're not alone. See every WebStorm problem users report or the alternatives people switch to.

Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.

Talk to us
Fixed it? Share this guide

The same problem in other apps

All slow, laggy or resource-hungry guides →

Other WebStorm errors