Simple Custom CSS and JS


Customize your WordPress site’s appearance by easily adding custom CSS and JS code without even having to modify your theme or plugin files. This is perfect for adding custom CSS tweaks to your site.


  • Text editor with syntax highlighting
  • Print the code inline or included into an external file
  • Print the code in the header or the footer
  • Add CSS or JS to the frontend or the admin side
  • Add as many codes as you want
  • Keep your changes also when you change the theme


  • Manage Custom Codes

  • Add/Edit Javascript

  • Add/Edit CSS

  • Add/Edit HTML


  • From the WP admin panel, click “Plugins” -> “Add new”.
  • In the browser input box, type “Simple Custom CSS and JS”.
  • Select the “Simple Custom CSS and JS” plugin and click “Install”.
  • Activate the plugin.


  • Download the plugin from this page.
  • Save the .zip file to a location on your computer.
  • Open the WP admin panel, and click “Plugins” -> “Add new”.
  • Click “upload”.. then browse to the .zip file downloaded from this page.
  • Click “Install”.. and then “Activate plugin”.


  • Download the plugin from this page.
  • Extract the .zip file to a location on your computer.
  • Use either FTP or your hosts cPanel to gain access to your website file directories.
  • Browse to the wp-content/plugins directory.
  • Upload the extracted custom-css-js folder to this directory location.
  • Open the WP admin panel.. click the “Plugins” page.. and click “Activate” under the newly added “Simple Custom CSS and JS” plugin.


What if I want to add multiple external CSS codes?

If you write multiple codes of the same type (for example: two external CSS codes), then all of them will be printed one after another

Will this plugin affect the loading time?

When you click the Save button the codes will be cached in files, so there are no tedious database queries.

Does the plugin modify the code I write in the editor?

No, the code is printed exactly as in the editor. It is not modified/checked/validated in any way. You take the full responsability for what is written in there.

My code doesn’t show on the website

Try one of the following:
1. If you are using any caching plugin (like “W3 Total Cache” or “WP Fastest Cache”), then don’t forget to delete the cache before seing the code printed on the website.
2. Make sure the code is in Published state (not Draft or in Trash).
3. Check if the wp-content/uploads/custom-css-js folder exists and is writable

Does it work with a Multisite Network?


What if I change the theme?

The CSS and JS are independent of the theme and they will persist through a theme change. This is particularly useful if you apply CSS and JS for modifying a plugin’s output.

Can I use a CSS preprocesor like LESS or Sass?

For the moment only plain CSS is supported, but you can check out the Pro version in case you need a CSS preprocessor.

Can I upload images for use with my CSS?

Yes. You can upload an image to your Media Library, then refer to it by its direct URL from within the CSS stylesheet. For example:
div#content {
background-image: url(‘’);

Can I use CSS rules like @import and @font-face?


Who can publish/edit/delete Custom Codes?

By default only the Administrator will be able to publish/edit/delete Custom Codes. On the plugin activation there is a role created called Web Designer. You can assign this role to a non-admin user in order to allow to publish/edit/delete Custom Codes. On the plugin’s Settings page there is an option to remove this role.

My website has HTTPS urls, but the codes are linked as HTTP

The URL for the linked Codes is built just like the URL for other media (from Media Library) by using the WordPress Address option found on the WP Admin -> Settings -> General page, as shown in this screenshot. If the WordPress Address has HTTPS in the url, then the Custom Codes and all the other media will have HTTPS in the url.


20 İyun 2024 2 replies
Hello. I just updated custom CSS name permalink, but it doesnt’t change. I need that “wp-content/uploads/custom-css-js/8103.css?v=4903” was converted in “wp-content/uploads/custom-css-js/custom_footer.css”. Thanks a lot in advnace.
21 Fevral 2024 1 reply
I’ve been using this plugin for a little over 2 years on over 50 sites (free and pro). It’s really been an amazing tool, especially the pro version with the ability to prioritize which CSS and HTML blocks are loaded. That is the only downside to the free version honestly. In the free version, using CSS and an HTML for something like the Bootstrap CDN causes the CDN to always load the Bootstrap CSS after causing me to either add !important to everything or using a less convenient solution. My biggest issue with the current update is the change in the stylelint and it is the reason I’m giving this plugin 3 stars. The new rules are too aggressive and are demanding many new conditions on the coding in CSS. I don’t want a linter to force me into what style of CSS I write in. Please set it back or begin to include a setting to configure the stylelint so that if I want to use the prefix for media queries, or not use kebab casing for Ids and classes, I don’t constantly have the editor giving me useless warnings. It really became an issue after having updated multiple sites and now the error is everywhere. I’ve commented out the sections for kebab-casing and changed the rule for the media queries in .js file but the time required to change it on every site, plus the next time there’s an update, I’d end up having to redo it all again. If this can be changed great. If not, I’m going to end up having to find another solution because it’s throwing error messages everywhere now and makes debugging more difficult.
26 İyul 2023 1 reply
This is a nice handy plugin, but it seems to not load CSS on Elementor pages for some reason. Otherwise nice plugin.
Read all 90 reviews

Contributors & Developers

“Simple Custom CSS and JS” is open source software. The following people have contributed to this plugin.


“Simple Custom CSS and JS” has been translated into 16 locales. Thank you to the translators for their contributions.

Translate “Simple Custom CSS and JS” into your language.

Interested in development?

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



  • 05/27/2024
  • Fix: use the GMT time for showing when a custom code was published or modified


  • 01/31/2024
  • Tweak: update the Bootstrap and jQuery library links
  • Tweak: remove the qTranslate-x warning. The qTranslate-x plugin was removed from since Aug 2021


  • 10/17/2023
  • Fix: enqueue the jQuery library only if there is a frontend JS custom code that requires it


  • 06/07/2023
  • Compatibility with the WooCommerce “custom order tables” feature


  • 03/13/2023
  • Fix: PHP8.1 deprecation notices
  • Fix: after adding a JS/HTML custom code with empty content will show the CSS default message in the editor


  • 01/17/2023
  • Fix: the “LH Archived Post Status” plugin was removing the “Publish” button on the add/edit custom code page
  • Feature: multiple values for the “Where in site” option

See changelog for all versions.