🚀 Overview

Custom Username Icons – XF2 (by XFA) is a XenForo-2 add-on that lets you display one or multiple icons right beside a member’s username, everywhere the username is rendered on your board — threads, member cards, conversations, and (in most versions) popular add-ons that rely on <xf:username>. It gives communities a simple way to highlight staff, premium members, winners, boosters, or any custom role with a visual badge. :contentReference[oaicite:1]{index=1}

Admins can offer icons from a Font Awesome list (500+ icons) or from their own image set; users can pick allowed icons from their account page; and moderators/admins can force icons on specific accounts or usergroups. Version 5.x even supports multiple icons per user. :contentReference[oaicite:2]{index=2}

✨ Key Features

• 🖼 Icons beside username everywhere – thread view, member tooltip, profile, alerts, and most add-ons that use the core username template. :contentReference[oaicite:3]{index=3}
• 🧱 Font Awesome + custom image icons – choose from the bundled FA set or upload your own PNG/SVG badges. :contentReference[oaicite:4]{index=4}
• ➕ Multiple icons (v5+) – let VIPs show several icons at once: staff + donator + tournament winner. :contentReference[oaicite:5]{index=5}
• ⚙️ Full ACP control – enable/disable per usergroup, limit which icons users can pick, force icons on selected members. :contentReference[oaicite:6]{index=6}
• 📍 Configurable position – left or right of username, with tooltip support (describe what the icon means). :contentReference[oaicite:7]{index=7}
• 💬 Works with chat / 3rd-party add-ons – designed to work wherever <xf:username> is used; minor tweaks may be needed for some chat plugins. :contentReference[oaicite:8]{index=8}

⚙️ Technical Stack

• Platform: XenForo 2.x add-on (tested on 2.1–2.3 in community mirrors). :contentReference[oaicite:9]{index=9}
• Tech: XF2 add-on structure (PHP 7.4+/8.x), XF templating, FA icons, optional image uploads.
• Dependencies: A working XF2 board, proper file permissions for icon uploads.

Expertise: XF admins with normal add-on install skills can deploy this in minutes.

🧩 Installation Guide

1. 📥 Download the add-on zip (xfa/CustomUsernameIcons) from your marketplace/community. :contentReference[oaicite:10]{index=10}
2. 📂 Upload the contents to your XenForo root as per readme (or use XF’s “Install/upgrade from archive”).
3. ⚙ In ACP → Add-ons → install “Custom Username Icons”.
4. 🛠 Go to ACP → Groups & permissions → set which usergroups can choose icons.
5. 🖼 Add or enable Font Awesome / custom image icons; set icon position (left/right) and max icons per user.
6. ✅ Test on: thread view, profile view, member card, and any chat/add-on you use.

📦 Deliverables

• 📁 XF2 add-on files (upload + install)
• 📘 Basic admin configuration guide
• 🎨 Example icon set (FA-based) + option to upload your own
• 📄 This SEO / E-E-A-T HTML description for resource/GPL sites

📱 Supported Platforms

• 🖥 XenForo 2.x (2.1–2.3+) forums :contentReference[oaicite:11]{index=11}
• 🧩 Most XF2 add-ons that rely on the username template
• ☁ Any Linux/PHP/MySQL hosting stack supported by your XF installation

🧠 Notes

License: This description is written for GPL/resource-style catalogs. Original item is a paid XF2 add-on from XFA on xenforo.com — purchase the official license for support & updates. :contentReference[oaicite:12]{index=12}

Customization tips: create “rank packs” (gold/silver/mod), use tooltips to explain icons, and lock premium icons behind user upgrade.

SEO assurance: target “custom username icons XF2”, “xenforo badge next to name”, “xenforo fontawesome username plugin”; add SoftwareApplication schema to your listing.

👨‍💻 Original Developer Credit

Developed by XFA (XenForo Add-ons) and published on the official XenForo community as “[XFA] Custom Username Icons – XF2 (Paid)”. Please retain their credit and link when redistributing. :contentReference[oaicite:13]{index=13}

🔒 Disclaimer

This HTML description is for informational/listing purposes only and is not the official XFA documentation. Features and supported XF versions may change — always check the xenforo.com resource page for the latest build and compatibility notes. :contentReference[oaicite:14]{index=14}