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.

Particle Background WP


Add the particles.js JavaScript library to add cool particle effects to any WordPress page ( demo: ).

Uses shortcode or easy options for adding to the front page or blog page of WordPress.

Fully customize the particles using your own JSON or the built in color & density settings

Leave a comment in the support forum for any suggestions or bugs.


Add particle background to home or blog pages with one click
Add particle background to any page using shortcodes
Customize the background color and dot color
Add any HTML just like a WordPress post to display on top of the particle background (optional)


  • Default Setting
  • Admin screen


  1. Upload the plugin file to your /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. In your sidebar, select ‘Particle Backgrounds’ to get started


How can I add my own particles.js config file?

Method 1: Add a directory in your theme called particle-background-wp and copy your particlesjs-config.json file to that folder. The json will automatically be loaded.
Method 2. Add a filter rn-pbwp-custom-json that returns a JSON string of the config.

How can I customize which pages the particle background appears on?

Method 1: Use the one-click buttons to add particle background to your Blog or Home pages
Method 2: Insert the shortcode [particle-background-wp] on the page you want to add a particle background to.
Method 3: Use the filter rn-pbwp-enqueue to return true to add particle background to a page.


Januari 2, 2019
It works, but it was hard to find how to make this a background. For anyone who's looking for a solution, I used this code: ` div#rn-pbwp-div { position:absolute!important; z-index:-1!important; } ` Then it appears on top of the WP backend, so it's kind of messy. But at least the front end looks and works good. If the app doesn't get updated, I will probably find a way to integrate particles.js manually.
Juni 20, 2018
this makes it background (in custom css): div#rn-pbwp-div { position:fixed!important; z-index:-1!important; }
Juni 5, 2018
The particle effect is awesome, but this is not a background, it's an animation that gets added to the top of the page where you want the background to be used. A real background "melts" with the page. Make it a real background and I will put you 5 stars because I really like the effect.
April 27, 2018
looked promising, but shows up only at the top of the page not usable as a background. That is not mentioned in the reviews only, but also in all unresolved topics. the author obiously does not care, nobody receiced a solution.
Pébruari 28, 2018
You've done a great job. But the thing is, it's going on the very top of the page, and not like a background. even topper than the menu, actually plugin doesn't care where do I put the shortcode, always running the code in the same position on top of the screen.
Read all 7 reviews

Contributors & Developers

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



Particle Background WP 2.0.0

  • Added ability to target CSS selectors to fill with particles(!)
  • Rewrote shortcode behavior to fill the parent with particles, instead of inserting a top section
  • A few UI updates

Particle Background WP 1.1.0

  • Added particle density slider
  • Added a filter for custom JSON
  • Added a theme-specific particle json support. Add /particle-background-wp/particlejs-config.json to your theme to automatically load a particles.js JSON config file
  • Added a filter for enqueuing the particle script ( ‘rn-pbwp-enqueue’ ) – true to enqueue the particles on that page
  • Fix shortcodes not working in the content input

Particle Background WP 1.0.0

  • Initial Release