How To Add Particle Effects to Themify Builder

Particles.js Demo

Particles.js is a free script created by Vincent Garreau that can be used to add fun animated elements to the background of your WordPress Theme and Themify Builder row elements. There are a number of ways to implement this script, such as plugins, child themes or custom functions. However, the following tutorial will show you how to add particles to any Builder row of your existing site with a few simple clicks.

To start, you will need a WordPress site with an active Themify theme using the Themify Builder, and a page created with a Builder row where you want the particles to appear. Check out the demo to see how it turns out!

Step 1: Add The Particle Class to Your Builder Element

  • Open the page you want to customize in a new tab and click Themify Builder > Turn on Builder in your admin bar at the top.
  • Click the Options icon in the row’s toolbar that you want to add the particles to

    themify builder row options
  • Enter particles-js into the Additional CSS Classes field and click Save


Step 2: Add Particle Script to Your Theme

  • Go to Themify Ultra > Themify Options from the admin menu
  • Under the General settings tab, copy and paste the following into the Footer Code box:
    <script src="//"></script>
    let particles_config = {
      "particles": {
    	"number": {
    	  "value": 80,
    	  "density": {
    		"enable": true,
    		"value_area": 800
    	"color": {
    	  "value": "#ffffff"
    	"shape": {
    	  "type": "circle",
    	  "stroke": {
    		"width": 2,
    		"color": "#a16eee"
    	  "polygon": {
    		"nb_sides": 7
    	  "image": {
    		"src": "img/github.svg",
    		"width": 100,
    		"height": 100
    	"opacity": {
    	  "value": 0.5,
    	  "random": false,
    	  "anim": {
    		"enable": false,
    		"speed": 1,
    		"opacity_min": 0.1,
    		"sync": false
    	"size": {
    	  "value": 3.945738208161363,
    	  "random": false,
    	  "anim": {
    		"enable": false,
    		"speed": 40,
    		"size_min": 0.1,
    		"sync": false
    	"line_linked": {
    	  "enable": true,
    	  "distance": 150,
    	  "color": "#ffffff",
    	  "opacity": 0.4,
    	  "width": 1
    	"move": {
    	  "enable": true,
    	  "speed": 6,
    	  "direction": "none",
    	  "random": false,
    	  "straight": false,
    	  "out_mode": "out",
    	  "bounce": false,
    	  "attract": {
    		"enable": false,
    		"rotateX": 600,
    		"rotateY": 1200
      "interactivity": {
    	"detect_on": "canvas",
    	"events": {
    	  "onhover": {
    		"enable": true,
    		"mode": "repulse"
    	  "onclick": {
    		"enable": false,
    		"mode": "push"
    	  "resize": true
    	"modes": {
    	  "grab": {
    		"distance": 400,
    		"line_linked": {
    		  "opacity": 1
    	  "bubble": {
    		"distance": 400,
    		"size": 40,
    		"duration": 2,
    		"opacity": 8,
    		"speed": 3
    	  "repulse": {
    		"distance": 200,
    		"duration": 0.4
    	  "push": {
    		"particles_nb": 4
    	  "remove": {
    		"particles_nb": 2
      "retina_detect": true
    window.addEventListener( 'load', function() {
    	document.querySelectorAll( '.themify_builder_row.particles-js' ).forEach( function( el, i ) {
    		const container = document.createElement( 'div' ); = 'tf_particles_' + i;
    		container.className = 'tf_abs tf_w tf_h';
    		el.prepend( container );
    		particlesJS( 'tf_particles_' + i, particles_config );
    	} );
    } );
  • Click Save at bottom right. View or reload your page in a new tab and voila!

Optional: Customize Your Particles

  • Go to to view the demo.
  • Explore the customization options in the upper-right by expanding the panels. These options allow you to change aspects of the particles such as color, shape and behavior.
  • When satisfied, click Download current config(json) and save the file to your Desktop.

  • Open the json file in a default text editor or code editor and copy the contents of the file (Ctrl/Cmd+C)
  • Under Themify Ultra > Themify Options, locate the following line in your Footer Code:
  • let particles_config = {
  • Now remove everything from the { character until before this line:
  • window.addEventListener( 'load', function() {
  • By now it should look like this:
  • Now right after the =, paste the json code from your file (Ctrl/Cmd+V)


  1. Usha
    Nov 22, 2016 @ 20:34

    Oh… It looks awesome… :)

    Would love to implement this on our blog.


  2. Daubié Claude
    Nov 26, 2016 @ 13:48

    est – il possible de l’utiliser avec le theme PARALLAX ?

    Is it possible to use it with the PARALLAX theme?


    • Kurt @ Themify
      Nov 27, 2016 @ 05:56

      Yes, this is possible with all our themes :)


  3. Andrej
    Dec 08, 2016 @ 14:31

    Thanks for this tutorial. Does this work with other WordPress themes than Themify, too?


    • Kurt @ Themify
      Dec 09, 2016 @ 18:02

      Yes, it’ll work with other themes as well but you’ll need to have the Themify Builder (


  4. Usha
    Dec 12, 2016 @ 22:28

    Will it work with Themify Ultra version 1.3.6?


  5. Emad Rahman
    Feb 04, 2017 @ 20:14


    You tutorial worked but partially. When the site is being seen from mobile or tablet, the particle background is not working there!

    Have a look here:


    • Nick @ Themify
      Feb 06, 2017 @ 16:05

      Just checked your site on iPhone. The particles background seems to be working fine.


  6. sasha
    Apr 03, 2017 @ 14:46

    i does not work, i did everything ok for the NOT custom adding particles but nothing happens.


  7. Hossein Rad
    Apr 08, 2017 @ 00:14

    It seems making my website a little slow , but really good one.
    Thank you very much.


  8. SAM33R
    Jun 11, 2017 @ 14:47

    this is not working.
    i mean the particles are not responding to mouse hover can you tell me how to fix this
    thanks in advance


    • Kurt @ Themify
      Jun 13, 2017 @ 01:28

      Please allow us to help you with this. Do you mind contacting us here – ? Thank you for your patience.


  9. Hiero Crepaldi
    Sep 13, 2017 @ 16:16

    Tks guyz! Amazing tutorial!!

    The video tutorial link is broken:

    The only thing doesn’t work was interactivity with mouse and background at the same time. (Clicks, bubbles and moves)


    • Kurt @ Themify
      Sep 14, 2017 @ 15:36

      Seems to be working on our end here. Do you mind double checking again? With regards to your suggestion, we’ll look into it in future tutorials :)


  10. Sergey Bityukov
    Sep 20, 2017 @ 09:23

    Does this effect work with ultra? Because i add it and nothing to see


    • Kurt @ Themify
      Sep 20, 2017 @ 16:40

      Yes, this works with Ultra. Please allow us to help you with this. Do you mind contacting us here – ?


      • michael shen
        Nov 24, 2018 @ 03:54

        hi! Kurt, do you know how to upload the customized file? Becoz I just followed up the tutorial, but it still didn’t work. Thanks!


    Dec 20, 2017 @ 17:22

    Hi Team Themify! ;)
    Does any other SVG animation work with themify themes? If yes, how can I add sg to get an animated background?


    • Nick @ Themify
      Jan 05, 2018 @ 02:29


      Could you provide a sample URL for review? I can pass it to your our developers.


      • Gurwinder Singh
        Feb 01, 2018 @ 05:35

        Hi Nick,

        Can we add this Codepen CSS animation, here is the URL:

        I am trying to add this to my Ultra theme.

        Appreciate your help.

        Thank you


  12. Ryan
    Jan 04, 2018 @ 21:48

    Is there a way to change the effect image on the themify theme shoppe?


  13. David
    Feb 27, 2018 @ 14:17

    is it possible to have the particles on a single column, not on the entire row?


  14. Dawn
    Apr 16, 2018 @ 17:48

    Hi, I just get bubbles outside the main module and not on it. Can you help please?


  15. akash
    Jun 26, 2018 @ 13:26

    This features is amazing


  16. jamie
    Sep 15, 2018 @ 21:58

    Amazing feature, how do you add this effect to more than one section? When i do it only shows on one section when i have inserted the css particles-js to more than one section



  17. Tu Du
    Dec 17, 2018 @ 02:35

    It looks awesome…


  18. Cagatay Oe
    Dec 22, 2018 @ 09:14

    Can you tell me where to find the “particlesJS(‘particles-js’); ” within the Header Code which just had been copied from the “Step 2: Add Particle Script to Your Theme” Section?


  19. Csaba @ Themify
    Dec 22, 2018 @ 21:10

    Hi Cagatay,

    Please copy the code from Step 2 and paste it to Themify Ultra > Themify Settings > General => Header Code.


  20. Cagatay Oe
    Dec 22, 2018 @ 21:19

    It was actually an ironic question. The parenthesis is, if I am not mistaken, a curly parenthesis…


  21. Leonardo Gravili
    Jan 13, 2019 @ 19:51

    Hello everybody! I managed to add particles effect to my site and it works, also with interactivity. The only problem is that doesn’t work if I enable Builder Section Scrolling on the page. Any suggestions?


    • Leonardo Gravili
      Feb 20, 2019 @ 17:56

      Hi, it’s possible to have an answer please?


  22. Florian
    Jan 19, 2019 @ 17:25

    I tried everything and it doesn’t work, can someone help me?


  23. Al JUNAID
    Sep 15, 2019 @ 17:24

    Hi, thanks for this amazing effect, but i think there is a little problem, it is not working when browsing the website on mobile
    do you any suggestion?


    • Csaba @ Themify
      Sep 16, 2019 @ 16:37


      The particles may not work on every mobile device or mobile browser, I tested on iPhone 7 in Safari, Chrome and Firefox, it works. Maybe check our demo on your device and if the demo doesn’t work, then your device / mobile browser can’t work with particles.


  24. Vick
    Apr 11, 2020 @ 17:18

    Thank you for this amazing tutorial.
    I adder this particles effect as described in the tutorial but no effect after refreshing my browser. The website is not online, I still working on my localhost (on my computer). Is this the main cause of not seeing the beautiful effect?


  25. Paul Decsy
    Apr 28, 2020 @ 00:13

    To everyone that may land here because the particles js has no intractability ( no effects on hover or on click), just add this –> “z-index: 2;” (or any number higher than 0, also without quotes) to the part.

    By default, the divs from Themify are having the z-index set to 0, but when you set up your particles using this guide the div containing the script has also the z-index set to 0, meaning that it is set to the background and thus no way to interact with it. There’s more to it but this should solve all the issues.

    Now, where’s my cookie?


    • Paul Decsy
      Apr 28, 2020 @ 00:17

      Alternatively, you can set the interactivity to detect_on: “window” from detect_on:”canvas”