# How to properly add a custom usermod (Usermods configuration not found)

**URL:** <https://wled.discourse.group/t/how-to-properly-add-a-custom-usermod-usermods-configuration-not-found/5323>\
**Category:** Usermods\
**Created:** [May 6, 2022, 3:05pm UTC](https://wled.discourse.group/t/how-to-properly-add-a-custom-usermod-usermods-configuration-not-found/5323 "2022-05-06T15:05:45Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![zettseb](https://yyz2.discourse-cdn.com/free1/user_avatar/wled.discourse.group/zettseb/32/3146_2.png) [@zettseb](https://wled.discourse.group/u/zettseb)\
**Post date:** [May 6, 2022, 3:05pm UTC](https://wled.discourse.group/t/how-to-properly-add-a-custom-usermod-usermods-configuration-not-found/5323/1 "2022-05-06T15:05:45Z")

</div>

Hi community,

thanks in advance for you help!  
I am trying heavily to bring a custom usermod to my WLED compile on ESP2866 (via PlatformIO and Visual Studio Code), so far without success… Can you maybe help me here?

I have added my usermod file to a separate folder in the usermod directory.  
Then I added the usermod specification in both places in wled00/usermods\_list.cpp, as described.

Finally, I copied the d1\_mini environment to the platformio\_override and added  
build\_flags = … -D MY\_USERMOD  
lib\_deps = … ESP8266HTTPClient  
(the latter being required for my usermod, otherwise I get a compilation error).

Now I am able to compile, and WLED is running on my ESP2866, but the usermods section in the GUI still says “Usermods configuration not found.” ☹

Can someone help me? Probably I am doing some stupid mistake, but unfortunately I couldn’t find better help regarding my question after 4 hours of research…

---

<div class="post-metadata">

**Author:** ![blazoncek](https://yyz2.discourse-cdn.com/free1/user_avatar/wled.discourse.group/blazoncek/32/1886_2.png) [@blazoncek](https://wled.discourse.group/u/blazoncek)\
**Post date:** [May 6, 2022, 3:19pm UTC](https://wled.discourse.group/t/how-to-properly-add-a-custom-usermod-usermods-configuration-not-found/5323/2 "2022-05-06T15:19:00Z")

</div>

Usermod will only show in settings page if you configure it to do so (addToConfig()).  
Please examine existing usermods, there are plenty, and try to duplicate what is done there. There are plenty of instructions available in readme files of existing usermods.  
If you are still stuck, publish your work on Github so we can see what you have done and try to help.

---

<div class="post-metadata">

**Author:** ![FrancFranc](https://avatars.discourse-cdn.com/v4/letter/f/c6cbf5/32.png) [@FrancFranc](https://wled.discourse.group/u/FrancFranc)\
**Post date:** [September 22, 2023, 1:45pm UTC](https://wled.discourse.group/t/how-to-properly-add-a-custom-usermod-usermods-configuration-not-found/5323/3 "2023-09-22T13:45:19Z")

</div>

can you explain the “(addToConfig()))” please?
