I am running a sports community forum on Flarum 2.0.2 and am replacing default FontAwesome tag icons with custom local image assets (.jpg/.png) exclusively via the Admin Dashboard Custom CSS panel [ExplicitMemoryClaims].
What I expected:
I expected to assign a FontAwesome placeholder tag hook in the Admin panel for two newly added forums (NCAA Forum and Boxing, UFC, MMA), and then use Custom CSS to replace those placeholders with my custom graphics scaled to 36px—matching the exact look of my original four boards [ExplicitMemoryClaims].
What I got instead:
Every time I apply the image swap CSS to the new tags, the icon vanishes into a completely blank space [ExplicitMemoryClaims]. Even worse, the text label layout breaks completely—the wording for the tag shifts entirely out of alignment, causing the letters to stack directly underneath the text of the forum category right above it.
Why I believe FontAwesome naming architecture is the root cause
My original four forums (Sixers, Eagles, Phillies, and Flyers) work 100% flawlessly on both the left sidebar and the right thread list badges using their legacy FontAwesome 5 naming rules [ExplicitMemoryClaims]. Those original four working selectors look exactly like this:
css
/* Target the left structural wrappers to allow 36px sizing */
.sideNav .TagLinkButton .Button-icon.fa-basketball-ball,
.sideNav .TagLinkButton .Button-icon.fa-football-ball,
.sideNav .TagLinkButton .Button-icon.fa-baseball-ball,
.sideNav .TagLinkButton .Button-icon.fa-hockey-puck {
width: 36px !important;
height: 36px !important;
display: inline-flex !important;
align-items: center !important;
justify-content: center !important;
}
/* Ensure the text labels sitting next to the logos center natively */
.sideNav .TagLinkButton:has(.fa-basketball-ball),
.sideNav .TagLinkButton:has(.fa-football-ball),
.sideNav .TagLinkButton:has(.fa-baseball-ball),
.sideNav .TagLinkButton:has(.fa-hockey-puck) {
display: inline-flex !important;
align-items: center !important;
min-height: 42px !important;
}
Use code with caution.
The problem is that FontAwesome 5 never had a free, built-in sports equivalent icon code for Combat Sports or NCAA (their boxing icons were locked behind Pro). When we try to use newer free icons like fas fa-fist-raised or map them to simplified slugs like fighting, Flarum 2.x compiles the HTML layout containers or class names completely differently than the legacy fa-basketball-ball types. This class nesting difference causes the custom background image to fail to render and completely warps the flexbox row formatting.
Flarum information
text
Flarum core: 2.0.2
PHP version: CLI: 8.3.6, Web: 8.3.6
PHP memory limit: CLI: -1, Web: 512M
MariaDB version: 10.11.14 (below the recommended MariaDB 11.8.0)
+-----------------------------+--------------+--------+-------+
| Flarum Extensions | | | |
+-----------------------------+--------------+--------+-------+
| ID | Version | Commit | Notes |
+-----------------------------+--------------+--------+-------+
| flarum-deck | v2.0.2 | | |
| flarum-flags | v2.0.1 | | |
| flarum-tags | v2.0.1 | | |
| flarum-suspend | v2.0.1 | | |
| flarum-approval | v2.0.1 | | |
| flarum-statistics | v2.0.1 | | |
| flarum-mentions | v2.0.1 | | |
| stezkoy-pagify | 2.0.0 | | |
| forumaker-magicbb | 2.5.1 | | |
| fof-user-bio | 2.0.0 | | |
| fof-upload | 2.0.2 | | |
| fof-reactions | 2.0.1 | | |
| fof-polls | 3.0.1 | | |
| fof-gamification | 2.0.0-beta.5 | | |
| fof-forum-widgets-core | 2.0.2 | | |
| fof-discussion-templates | 2.0.0-beta.1 | | |
| flarum-subscriptions | v2.0.1 | | |
| flarum-sticky | v2.0.1 | | |
| flarum-nicknames | v2.0.1 | | |
| flarum-messages | v2.0.2 | | |
| flarum-markdown | v2.0.1 | | |
| flarum-lock | v2.0.1 | | |
| flarum-lang-english | v2.0.0 | | |
| flarum-emoji | v2.0.1 | | |
| flarum-bbcode | v2.0.1 | | |
| ernestdefoe-importer | v0.3.6 | | |
| ernestdefoe-espn-cfb-ticker | v2.0.14 | | |
+-----------------------------+--------------+--------+-------+
Base URL: https://extremephillysportsforum.com