How to integrate the "Particles.js" Javascript library in Divi? Have you ever spotted this guy? interactive background in Divi or on any other type of site? Constellations which magnetize in the passage of your mouse, stars or even snow Who's falling? This guy. interactive background is possible thanks to the Javascript library of the Vincent Garreau : Articles.
Nothing more hypnotizing than this kind of background, right?
In this article, I will explain how to add an interactive background with Particles.js. You will see that in a few minutes, and without great knowledge (without coding), you can get this beautiful effect and use it on your Divi sites.
Here is the procedure:
- Install the plugin that will allow you to use the Particles.js library
- Define the type of particles you want to display
- Add interactive background to a section of Divi
- What are the other possibilities?
Update of June 2, 2024: After many comments left by readers concerning errors encountered, I confirm that Particles.js is well compatible with the latest version of Divi or WordPress. I just checked with the version 4.25.1 of Divi and version 6.5.3 of WordPress. Everything works fine. If you encounter errors, check each step and make sure that there is no code error: a simple space or comma wrongly placed could result in a failure. I also advise you to Do your tests on a test site and not on a production site.
1. Install the plugin that will allow you to use the Particles.js library in Divi
Even if this plugin is not indispensable, it will make life easier for you and avoid putting your hands in your Divi child theme. Even if in many cases it is interesting not to add too many plugins, this one is really light and will make your life easier, so why not?
So, for add an interactive background in Divi, the first step will be to download, install and activate the named extension ParticleJS-WP-Plugin. If you want to know more, here is the Github directory link.
This means that this is not an extension that is available directly from the official directory of WordPress plugins (via the menu Extensions > Install) but since Github, a repository dedicated to developers and in which you can trust.
Once you have installed and enabled this extension, a new tab will appear: "Particle Background"

So far, nothing good leaves... That's what's going to be interesting...
Do you know you can test Divi for free? See you on this page and click on "TRY IT FOR FREE"
2. Define the type of particles you want to display on your site
The second important step will be to set up the type of particles that you want to see appearing as interactive background. For this, I give you an appointment on the official website of Particles.js.

This screen will allow you to create your particles and you can define:
- particle style: circles, polygons, stars, images etc...
- speed and number,
- Particulate bonding,
- the direction of movement,
- Interactivity with Internet users,
- the color of the particles / background color,
- etc...
Once you have set the ideal particles using the Control Panel (top, right), you will no longer be left that to download the generated code. To do this, click on « Download current config (json) », the last element at the bottom of the particle control panel.

3. Add interactive background to a section of Divi
Now you have the two essential elements to create your Beautiful interactive background in Divi :
- on Particle Background plugin
- and the particle code.
You will only need to assemble it and integrate it into Divi. Here's what you need to do:
3.1 â Add the appropriate code in the Particle Background plugin
See you in the tab Particle Background and add this code:
particlesJS('my-particles',
ADD YOUR CODE HERE
);
In this example, unique identifier (ID) is "my-particles". This can be changed by an ID of your choice. However, know that an ID (HTML ID) can only be used once in a page. This is important information that you should keep in mind.
The line where is noted "ADD YOUR CODE HERE" is the location where you must paste the code obtained after configuration of your particles. The one you got in step 2 of this tutorial.
So the code to paste in the field provided for the tab Particle Background should look like this:
particlesJS('my-particles', { "particles": { "number": { "value": 109, "density": { "enable": true, "value_area": 800 } }, "color": { "value": "#ffffffff" }, "shape": { "type": "circle", "stroke": { "width": 0, "color": "#000000" }, "polygon": { "nb_sides": 5 }, "image": { "src": "img/github.svg", "width": 100, "height": 100 }; "opacity": { "value": 0.5, "random": { "anim": { "enable": "speed": 1, "opacity_min": 0, "syst": 150, "sync": { falt]: {falt], "04"": "58"": "":
Since each ID must be unique, if you want to use various interactive backgrounds, you will have to change the ID every time you repeat the code.
If you watched my video at the beginning of the article, you might have noticed that I added 3 backgrounds in a row. This was possible because for each background, I used different IDs as "my-particles", "my-particles-2" or "my-particles3".
Update of 23 June 2019 : Here is the example of the code I used to be able to use integrate 3 different background articles within one page. The 3 pieces of code were glued in a row with 1 double jump to separate them =>
particlesJS('my-particles', { "particles": { "number": { "value": 109, "density": { "enable": true, "value_area": 800 } }, "color": { "value": "#ffffffff" }, "shape": { "type": "circle", "stroke": { "width": 0, "color": "#000000" }, "polygon": { "nb_sides": 5 }, "image": { "src": "img/github.svg", "width": 100, "height": 100 }; "opacity": { "value": 0.5, "random": { "anim": { "enable": "speed": 1, "opacity_min": 0, "syst": 150, "sync": { falt]: {falt], "04"": "58"": "":
3.2 â Integrate your particles into a section of Divi
Now everything is ready for insert your particles into a section of Divi. Depending on whether you prefer to use the Divi Builder or Visual Builder, here is the method :
Method with the Divi Builder (back office):
When you Build your layout (page layout)you add sections, lines and modules.
The idea is that these particles cover the bottom of a section (standard section, full width section or even special section).
1 â You will need to add (or edit if already present) a section:

2 - Add a color background to your choice (especially if your particles are white) via the tab Content > Background :

3 â Insert the unique identifier (ID) that you used in the Particle Background plugin code (code previously seen, example "my-particle"). This ID inserts to the tab Advanced > CSS ID and classes :

Want to move to higher speed? Get the Divi theme now!
4 - Save your changes, update your page and admire your starry sky!!! Note that you may need to add some internal margin to enlarge the section.
Method with Visual Builder (front-office):
If you prefer use Visual BuilderIt will be the same procedure.
IMPORTANT: Note you will not see your particles appear live when you use the Front End Builder. You will need to save and exit the visual builder to see your intercating background appear.


4. What are the other possibilities?
Finally, I wanted to inform you that there are other solutions to insert particles as an interactive background.
You could just download the Javascript library and add it to your child theme. This would require manual integration.
Otherwise, there is a free plugin on the official directory. This is Particle Backgroung WP. It is very simple to use. The only concern is that you will not be able to customize your particles, only the background color. A shortcode will allow you to add it easily but it's not the ideal way to integrate this into a section of Divi...
Before you leave: do you like designs that come out of the ordinary? Discover how to insert a background that changes color in Divi.
Need more resources on Divi? Visit ElegantTheme's blog full of ideas and tutos!


bonjour,
merci pour votre tuto,
j’ai un petit souci pour configurer plusieurs arriĂšre plans(j’en ai un seul qui fonctionne ou aucun selon la syntaxe), quelle est la syntaxe exacte dans particles background pour pouvoir le faire?
Comment fait t’on pour charger des images (glaces dans le tuto)?
merci d ‘avance pour la rĂ©ponse
Salut Damien, dans mon tuto, j’explique que si tu veux utiliser plusieurs arriĂšres-plan tu dois utiliser des ID diffĂ©rents, c’est trĂšs important (voir section 3 => Ajouter le code adĂ©quat dans le plugin Particle Background : l’exemple « my-particles » doit ĂȘtre changĂ© pour chaque nouveau code).
Concernant l’image Ă insĂ©rer (comme la glace dans ma vidĂ©o), tu dois la paramĂ©trer lorsque tu dĂ©finis tes particules sur le site https://vincentgarreau.com/particles.js/
Cette image doit dĂ©jĂ ĂȘtre dĂ©jĂ hĂ©bergĂ©e dans ton site. Tu vas dans ta bibliothĂšque de mĂ©dias et tu rĂ©cupĂšres l’URL de l’image en question.
Ensuite, cette URL doit ĂȘtre insĂ©rĂ©e dans le paramĂ©trage de tes particules au chemin suivant : PARTICLES > SHAPES > IMAGE > IMAGE.SRC
Tu me diras…
bonjour
je voulais ajouter un logo citroen sur le fond de ma page d’acceuil
j’indique le chemin dans PARTICLES > SHAPES > IMAGE > IMAGE.SRC et l’image sous forme jpg se trouve dans ma bibliotheque
pourtant il ne semble pas la reconnaitre et affiche des particules en mouvement
que faire?
C’est plutĂŽt bizarre, ça devrait marcher. Avez-vous rĂ©essayĂ© ? N’auriez-vous pas une erreur dans le lien de l’image ?
Bonjour, merci pour ce tuto.
J’ai malheureusement un problĂšme aucune image ne fonctionne lorsque je rentre l’url d’une image cela me remet des particules de bases pourrais tu m’aider stp ?
Merci
Bonjour Sonny,
Dommage, il y a certainement une Ă©tape qui s’est mal passĂ©e. Par exemple : est-ce que l’URL de l’image est bonne ? As-tu essayĂ© avec une autre URL pour voir si ça ne venait pas de l’image en elle-mĂȘme ? Parfois, ça ne tient Ă pas grand chose !
Bonjour, comment puis-je utiliser plusieurs backgrounds différents pour différentes pages ?
Sur votre tuto je lis de les diffĂ©rencier d’un ID diffĂ©rent.
Je ne suis pas sûr de la syntaxe dans le code JSon, je ne sais pas comment ajouter un deuxiÚme id.
J’ai essayĂ© de les « raccorder » comme ça :
https://www.zupimages.net/up/19/19/rxdm.png
Et comme ça :
https://www.zupimages.net/up/19/19/dzai.png
J’ai ensuite prĂ©ciser l’idĂ©e my-particles-2 dans les id css,
mais aucun des deux ne semble fonctionner.
Si vous pouviez me renseigner svp, ça m’aiderait beaucoup đ
Salut Desportj,
Tu as trouvĂ© finalement ? Tes captures me semblent bonnes. Tu peux effectivement prĂ©fixer l’ID pour pouvoir dupliquer le code et qu’il n’y ait pas de conflits : my-particle, my-particle-2, my-particle-3
Peut-ĂȘtre que le souci vient d’ailleurs ?
As-tu copiĂ©-collĂ© le code de mon article ? Si c’est le cas, regarde que les « apostrophes-droites » n’aient pas Ă©tĂ© remplacĂ©es par des « apostrophes-virgule » par exemple. C’est souvent le cas quand on copie-colle.
Bonjour j’ajoute les particules elles fonctionnent en haut de page mais j’aimerais uniquement l’insĂ©rer dans une section divi et rien ne fonctionne. pouvez vous m’aidez?
Quand j’inscris le code « json » il s’inscrit sur tout le site.
Comment puis-je faire?
Salut Morgane,
Je ne comprends pas trop ta question. Je crois que tout est bien expliqué dans le tuto. As-tu suivi les étapes scrupuleusement ?
pouvez vous indiquer comment vous faites pour mettre plusieurs particle background, au niveau du codage ? plusieurs personnes on ce probleme on dirait. une capture d’ecran par exemple ?
Bonjour,
Merci pour ce tuto, cependant fonctionne t-il avec la version 3.23.2 du thĂšme divi ?
Cela ne fonctionne pas chez moi….. :/
Bonjour Laurent, ça devrait fonctionner normalement… je crois…
Salut Yoyo!
Je vois que certains n’arrivent pas Ă utiliser plusieurs backgrounds au sein de la mĂȘme page. Pourtant, je ne peux pas ĂȘtre plus claire, c’est Ă©crit dans le tutoriel :
« Ătant donnĂ© que chaque ID doit ĂȘtre unique, si vous souhaitez utiliser divers arriĂšres-plans interactifs, vous devrez changer lâidentifiant Ă chaque fois que vous rĂ©pĂ©tez le code.
Si vous avez regardĂ© ma vidĂ©o en dĂ©but dâarticle, vous avez pu remarquĂ© que jâai ajoutĂ© 3 arriĂšres-plans Ă la suite. Cela a Ă©tĂ© possible car pour chaque background, jâai utilisĂ© des ID diffĂ©rents comme « my-particles », « my-particles-2 » ou « my-particles3 ». »
Bonjour,
Je rencontre un petit problĂšme avec ce plugin
J’ai suivi Ă la lettre les instructions d’installation et de paramĂ©trage
Il fonctionne trĂšs bien avec Chrome, mais les particules sont invisibles avec Mozilla ou Safari
Merci d’avance pour votre aide
Cordialement
Salut Gilles,
Hummm… C’est trĂšs bizarre. Pour ma part, j’ai rĂ©alisĂ© le tuto sur Firefox et ça marchait trĂšs bien… Je n’ai pas rĂ©essayĂ© depuis mais je ne vois pas pourquoi ça ne marcherait pas ?
Bonjour, je ne comprend pas, dans l’onglet paramĂštre j’ai seulement « Personnaliser Css » et rien d’autre.
Je ne peux donc pas rentrer l’ID CSS.
Bonjour,
AprĂšs 150 essais je nâarrive toujours pas Ă mettre en oeuvre les particules !
Pourtant j’ai le sentiment de tout faire, j’ai peur qu’un Ă©lĂ©ment de mon divi donne un contre ordre ou je ne sais quoi.
Pouvez vous mâaider ?
Bien Ă vous.
Salut Boby
Ăa dĂ©pend de ce que tu cherches. Dans « personnaliser CSS », tu peux saisir l’ID et la Class normalement.
Salut Antoine,
Tu n’es apparemment pas le seul qui rencontre des problĂšmes d’intĂ©gration. Du coup, je viens de suivre mon tuto comme un internaute le ferait. Tout fonctionne. Je confirme donc que Particles.js est compatible avec la derniĂšre version de Divi et de WordPress (soit 5.23 et 5.2).
Par contre, j’attire ton attention sur le fait que si tu insĂšres l’ID depuis le Visual Builder (en front-end), c’est normal de ne pas les voir apparaĂźtre au moment de la confection de ta page. Ajoute bien l’ID, enregistre le module et la page puis quitte le Visual Builder : les particules apparaĂźtront.
Si rien ne fonctionne, tu as peut-ĂȘtre un conflit avec un autre plugin.
Salut Lycia,
Merci pour tous tes tuto.
Je rencontre non pas un souci dâintĂ©gration mais un souci au niveau des dimensions.
Dans l’impression dâĂ©cran ci dessous, la section fait 300px.
Du coup l’effets est totalement Ă©crasĂ©.
https://zupimages.net/up/19/26/chyv.png
Ăa te parle ?
Ah oui, effectivement les particules sont Ă©crasĂ©es. Lors de mes tests, moi aussi l’icĂŽne de mon logo (la glace) s’est affichĂ©e Ă©crasĂ©e pendant un instant, mais aprĂšs rechargement de la page, le logo est redevenu normal. Peut-ĂȘtre une histoire de cache ?
Aurais-tu mis une rÚgle CSS pour donner une taille spécifique à ton BG ?
Genre [width:300px height:200px]. Si c’est le cas, il vaudrait mieux mettre un truc du genre [width:300px height:auto].
Sinon inspecte le code, ça pourrait venir de là .
Tu nous diras…
Bonne journée.
Lycia
Merci de ta rapidité.
Ce n’Ă©tait pas un problĂšme de cache et je n’avais rien de spĂ©cifiĂ© au niveau du BG.
Par contre le plugin ajoute un parametre de style « width: 100%; height: 100%; »
En ajoutant un parametre sur la class qui va bien, tout est OK đ !
.particles-js-canvas-el {
height: auto!important;
}
Ah super !
J’en Ă©tais sĂ»re que c’Ă©tait une histoire de height:auto !!!
Pour ma part, je n’ai pas rencontrĂ© ce problĂšme car mon icĂŽne est un .png carrĂ©. Genre 200px par 200px.
Ton image ne devait pas ĂȘtre carrĂ©e, d’oĂč le problĂšme rencontrĂ© je pense !
Ton cas pourras en aider d’autres…
Merci đ
TrĂšs bien, merci pour vos commentaires, une requĂȘte, j’utilise un curseur et je veux mettre cet effet sur ce curseur, mais l’effet n’apparaĂźt que lorsque la page est chargĂ©e et que la diapositive suivante est affichĂ©e, l’effet disparaĂźt. ou cet effet ne fonctionne pas sur un curseur?
Je vous serais reconnaissant de bien vouloir m’aider, Lycia, merci beaucoup pour votre aide.
Rolando Segovia
Lima Pérou
Salut Rolando, en parlant de curseur, tu parles d’un diapo ? Effectivement, c’est possible que cela ne marche pas, Ă moins de trouver l’ID qui va bien mais je n’ai pas testĂ© et je ne sais pas si cela est possible. DĂ©solĂ©e de ne pas pouvoir plus t’aider…
Bonjour lycia je n’ai pas trouvĂ© les autres vidĂ©os pour la suite de ce dĂ©mo, comment faire des particules en images dans ta chaine sur YouTube
Salut Skander. Ce tuto est pour Divi et WordPress. Je ne pense pas que tu puisses t’en servir pour ta chaine YT.
Bonjour, je souhaiterais utiliser mon logo (comme vous vous utilisez la glace) comment faire s’il vous plaĂźt.
Bonjour Amandine,
Tout est expliquĂ© dans le tuto. Tu devras hĂ©berger ton image sur ton site et rĂ©cupĂ©rer le lien (adresse URL). Ensuite, tu paramĂštres les particules depuis le site officiel de ParticleJS avec l’adresse de ton image. Tu rĂ©cupĂšres le code et tu l’insĂšres dans ton site. Elle doit ĂȘtre en .png (fond transparent).
Bonne journée
bonjour j’aimerai configurer des particules dans ma section mais le problĂšme est que ma section Ă dĂ©jĂ un id qui me permet de faire reference Ă mon menu ancre comment je peux gĂ©rer ça?
Salut Levy, je vois ce que tu veux dire… Je ne sais pas, il faudrait regarder de plus prĂšs. Peut-ĂȘtre que tu pourrais utiliser une CLASSE CSS au lieu dâun ID ? Il faudrait voir si ça fonctionne… Je parle pour les particules, car pour ton ancre de lien, tu es obligĂ© dâutiliser un ID…
J’ai un problĂšme. J’ai bien installĂ© les particules, ça fonctionne super, tant que je suis connectĂ©. . .
DÚs que je ne suis plus connecté, plus de particules.
Savez-vous d’oĂč ça peut venir ?
C’est bizarre Charly.
Y’a peut-ĂȘtre un conflit quelque part ?
Possible, effectivement faudrait que je fasse des petits tests Ă ce niveau.
Bonjour,
Le tuto est parfait, merci. J’arrive Ă mettre des flocons de neiges ou mĂȘme des images, le problĂšme que je rencontre c’est que je ne peux pas faire les deux en mĂȘme temps. Que ce soit sur une mĂȘme page ou deux pages diffĂ©rentes, j’ai l’impression que dĂšs que je change l’ID ça rentre en conflit.
Aurait tu une idées.
Bonjour,
AprĂšs un nouvel essais en utilisant ton code Ă toi, ça fonctionne parfaitement sur une mĂȘme pages. Par contre lorsque je veux appeler les diffĂ©rents ID sur des pages diffĂ©rentes ça ne fonctionne pas, aurais tu une astuce pour contrer le bug ?
Salut Jonathan.
Je ne vois pas trop… Il te faut utiliser des ID bien distinct Ă chaque fois, comme expliquĂ© dans ce tuto. As-tu fait attention Ă cela ?
Ah d’accord, j’avais pas vu ton second commentaire !
Euh, normalement ça dois marcher si c’est sur une autre page.
Hi, im just having some issue. đ When i am logged in in DIVI it is working. But when i logged out it is not working.
I tried to inspect and it says Uncaught ReferenceError: particlesJS is not defined.
Hello Chris,
I don’t know what is wrong. Did you made the tutorial step by step ?
Bonjour
Je tente ma chance pour avoir de l’aide. J’ai suivi le tuto et rien Ă faire, impossible d’avoir la moindre animation alors que j’ai tout suivi sur 2 tutos diffĂ©rents. Mon code json est bon mais quand je mets mon ID CSS aprĂšs avoir dĂ©fini ou non une couleur de fond, rien. Pas de rĂ©action…
Merci
Salut Sof.., ben je sais pas, il faut retenter jusquâĂ trouver dâoĂč vient le problĂšmeâŠ
Bonjour.
Pendant plus de 4H sans mentir j’ai bien suivi le tutoriel et je n’ai toujours pas les particule qui s’affiche… aucune mise Ă jour depuis 2019 du coup je ne sais pas si le problĂšme viens de moi qui comprend mal ou pas…
Hello Lux, pas besoin de mettre l’article Ă jour, car le code fonctionne toujours đ Mais si tu savais le nombre d’internautes qui me disent « j’ai suivi Ă la lettre » et qui reviennent ensuite me dire, « ah en effet, j’avais pas bien lu le point n°x »… Donc, je ne saurais quoi te dire, peut-ĂȘtre que j’explique mal…
Bonjour,
Ăa fonctionne bien ! Par contre c’est limitĂ© Ă la taille de l’Ă©cran, si la section est plus petite que l’Ă©cran, les particules sont Ă©crasĂ©es et si elle est plus grande, elles sont Ă©tirĂ©es…
J’ai remarquĂ© ça car j’ai voulu le mettre sur toute la page (header et footer compris). J’ai rĂ©ussi mais les particules ne vont que quelques centimĂštres dans le footer (j’ai essayĂ© de changer « detect on : window ou canvas ou parent »)
Ou peut-ĂȘtre que j’ai fait quelque chose de faux ?
Je sais pas il faudrait faire plusieurs essais, merci du retour
Hello, déjà merci pour ce super tuto et cette superbe extension !
Alors par contre super bizarre, Ă partir du moment oĂč j’ai installĂ© l’extension, tout les sĂ©parateurs entre mes modules ont disparus…. et impossible Ă les remettre en place ! Sure mon builder il y est et quand je le quitte les sĂ©paration n’y sont plus…
Ah oui câest bizarre
Bonjour,
J’ai le mĂȘme soucis que Djin dans les commentaires le 25 Juin 2019
Seulement je n’ai pas compris sa solution …. Quel est la class qui va bien ? Je ne comprends pas sorry….
Pouvez-vous m’aider s’il vous plait ?
Merci beaucoup !
Salut Adrien, en fait Djin explique qu’une height est dĂ©finie et que c’est cela qui « écrase les particules ». En forçant le « height: auto!important; » cela corrige le problĂšme. Du coup, il faut effectivement inspecter le code dans ton navigateur pour trouver sur quelle classe positionner ces valeurs. Selon Djin, ce code rĂšglerait le problĂšme :
.particles-js-canvas-el {
height: auto!important;
}