This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.



Compiles .scss files on your wordpress install using lefo’s scssphp. Includes settings page for configuring directories, error reporting, compiling options, and auto enqueuing.

The plugin only compiles when changes have been made to the scss files. Compiles are made to the matching css file, so disabling this plugin will not take down your stylesheets. In the instance where a matching css file does not exist yet, the plugin will create the appropriate css file in the css directory.

Get detailed instructions on github


  1. Upload plugin to plugins directory
  2. Active plugin through the ‘Plugins’ menu in WordPress
  3. Configure plugin options through settings page settings -> WP-SCSS.


Installation Instructions
  1. Upload plugin to plugins directory
  2. Active plugin through the ‘Plugins’ menu in WordPress
  3. Configure plugin options through settings page settings -> WP-SCSS.
Can I use a child theme?

Yes, absolutely. Make sure you define your directories relative to your child theme and that your child theme is active. Otherwise you’ll see an error regarding missing directories.

How do I @import subfiles

You can import other scss files into parent files and compile them into a single css file. To do this, use @import as normal in your scss file. All imported file names must start with an underscore. Otherwise they will be compiled into their own css file.

When importing in your scss file, you can leave off the underscore.

@import 'subfile';

Does this plugin support Compass?

Currently there isn’t a way to fully support compass with a php compiler. If you want limited support, you can manually import the compass framework. You’ll need both the _compass.scss and compass directory.

`compass / frameworks / compass / stylesheets /

@import 'compass';

Alternatively, you can include Bourbon in a similar fashion.

Can I use .sass syntax with this Plugin?

This plugin will only work with .scss format.

It’s not updating my css, what’s happening?

Do you have errors printing to the front end? If not, check your log file in your scss directory. The css will not be updated if there are errors in your sass file(s).

Make sure your directories are properly defined in the settings. Paths are defined from the root of the theme.

I’m having other issues and need help

If you are having issues with the plugin, create an issue on github, and we’ll do our best to help.


March 25, 2019
Not sure if any of you have had this issue, but on the latest version, when I edit a scss file and save it, it will NOT compile and update on the first try. It requires me to go back in the file, and add some dummy test class with dummy code, 2-3 times, before a build is triggered. This is super annoying! I have found a fix for this however. Download the release from Make sure it is version 0.7.6 Open with a ZIP utility Navigate into the "bin" folder. You will see "pscss" Extract "pscss" into wp-content/plugins/wp-scss/scssphp/bin Instant builds will now trigger. Other than this bug, the plugin works very well, WHEN it actually compiles 😉
October 6, 2018
This is a very good plugin to make us use SCSS easier. Normally I use CodeKit to compile SCSS to CSS on localhost. But for some urgent projects we need to edit via FTP. This can help us a lot. Thank you so much.
September 22, 2018
When I have the plugin installed the system gets infected with spam links. There must be a security issue with this plugin. I have reinstalled my site twice and after a few days WordPress gets hacked. I am almost 100% that it is this plugin doing it. I have inte uninstalled now, lets see if I still get hacked 🙂 Please review the code!
September 16, 2018
Very simple start (basically you set 2 directories scss & css), always works well, can display errors directly on site but also only for the logged in users 🙂 And, it finally has source maps =) so you can go with compressed (yep, it also compresses the output css and you can even choose how!) css output with no remorse. It really brings so much and still keeps its simplicity.
Read all 47 reviews

Contributors & Developers

“WP-SCSS” is open source software. The following people have contributed to this plugin.


Translate “WP-SCSS” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Updated scssphp to version 0.7.5
  • Added source map @iannacone
  • Always define $wpscss_compiler in the global scope @jazbek


  • Updated scssphp to version 0.7.2 @hellerbenjamin
  • Removed depricated screen_icon()


  • Updated scssphp to version 0.6.6


  • Changed set version option to update if already exists


  • Fixed a bug where directory inputs were not getting sanitized @mmcev106
  • Made the missing directory warning also display if a specified path is a file @mmcev106
  • Added /vendor to .gitignore @mmcev106
  • Dont enqueue already enqueued stylesheets @bobbysmith007


  • Added filter to set variables via PHP @ohlle
  • Added option to minify CSS output @mndewitt


Various improvements from pull requests by @jbrains and @brainfork


  • Update scssphp to 0.0.12 – pull from #16 @GabrielGil


  • Upgraded to version 0.0.10; via pull request from kirkhoff


  • Added option to only show errors to logged in users; via pull request from tolnem


  • Add suport for subfolders in scss directory


  • Hotfix for a accidental character


  • Added support for moved wp-content directories


  • Added error handling for file permissions issues
  • Changed error log to .log for auto updating errors


  • Initial Build