diff --git a/Troubleshooting.md b/Troubleshooting.md
index 1d4e3d4..d8180f8 100644
--- a/Troubleshooting.md
+++ b/Troubleshooting.md
@@ -3,6 +3,7 @@
 * [Some icons don't show up](#some-icons-dont-show-up)
 * [I'm developing my web app locally (file://) and icons from CDN don't show up](#im-developing-my-web-app-locally-file-and-icons-from-cdn-dont-show-up)
 * [I'm hosting fonts on my server and icons don't show up](#im-hosting-fonts-on-my-server-and-icons-dont-show-up)
+* [I'm using custom css classes with Font Awesome 5 and solid icons don't show up](#im-using-custom-css-classes-with-font-awesome-5-and-solid-icons-dont-show-up)
 * [Some brand icons are missing](#some-brand-icons-are-missing)
 * [Firefox on iOS caveats](#firefox-on-ios-caveats)
 * [Internet Explorer Compatibility Mode](#internet-explorer-compatibility-mode)
@@ -53,6 +54,14 @@ Check the following:
 
 ---
 
+#### I'm using custom css classes with Font Awesome 5 and solid icons don't show up
+
+Please add `font-weight: 900` to your custom css class
+
+Ref: [#11946](https://github.com/FortAwesome/Font-Awesome/issues/11946)
+
+---
+
 #### Some brand icons are missing
 You (or your customers) are probably using Adblock Plus. If the "Remove Social Media Buttons" option is enabled, you will miss some brand icons.