Local Help Docs Local Pro

Instant Reload

Local’s Instant Reload feature saves you time so you never have to click “refresh” in your browser again. Instant reload is helpful for:

  • Working with your code and browser side-by-side: Maintain flow-state and streamline previewing your CSS changes.
  • Debugging file changes: Local displays a log stream of your latest changes which helps make sure new changes are detected and displayed. 
  • Make edits in real time: Changes are displayed immediately meaning you’ll never have to clear your cache again.

Using Instant Reload

All of the Instant Reload functionality can be found within the “Instant Reload” section of the “Tools” tab in Local.

The general flow of using this tool looks like:

  1. Enable Instant Reload for the site
  2. Open the site within a browser
    • NOTE: You’ll know that Instant Reload is working correctly if you see the “Instant Reload Enabled” message within the browser.
  3. Edit a CSS file in your editor of choice. Once that file is saved, Instant Reload will automatically refresh those styles in the browser!

Local keeps a session log when a CSS file has changed. To view that log, navigate to the “Instant Reload” section of the “Tools” tab.


Instant Reload is enabled on a per-site basis. Once you’ve enabled Instant Reload, it will automatically start up when using Local in the future.

Instant Reload only watches wp-content/plugins and wp-content/themes for changes to .css files.

Changes that are made using page builders or other WordPress plugins which do not persist their changes to the filesystem will not be refreshed.

Instant Reload isn’t detecting my changes

Still not working? Try switching to localhost routing mode.