Local Help Docs Pro & Teams

Getting Started with Instant Reload

Local’s new Instant Reload feature, available in Local Pro, saves you time so you never have to click “refresh” in your browser again. Custom plugin and theme authors rejoice! Instant reload is helpful in other uses-cases too:

  • Work with your code and browser side-by-side: Maintain flow-state and streamline previewing your CSS changes.
  • Debug 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.

Enable Instant Reload

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

How can I tell Instant Reload is working?

When viewing a site, Local adds a “Instant Reload Enabled” alert to the upper right corner of your browser’s window. Instant Reload is enabled for all traffic to your Local Site: this includes wp-admin and non admin pages.

Which files does Instant Reload watch for changes?

Click into the Pro tab > Instant Reload, here you’ll find a stream of all the changes Local has detected for the current session (this stream resets when you quit Local).

note

Instant Reload watches wp-content/plugins and wp-content/themes for changes to .css files. Instant Reload does not detect changes for page builders or other WordPress plugins which do not persist their changes to the filesystem.

Instant Reload isn’t detecting my changes

Still not working? Try switching to localhost routing mode.