- Compatible XF 2.x versions
- 2.3
OverviewTired of a forum full of faceless default avatars? XFTech — Registration Avatar solves the problem at the source. This lightweight addon hooks directly into XenForo's native registration service and requires every new member to upload a profile picture before their account is created — no extra steps, no post-registration reminders, no workarounds needed.
Built 100% on native XenForo 2.3+ APIs. Zero external dependencies. Zero bloat.
Features
Mandatory avatar enforcement — Registration is blocked until a valid image is uploaded. No exceptions, no skipping.
Supports all major image formats — JPG, PNG, GIF, and WebP accepted out of the box.
Native XenForo upload pipeline — Uses XF's built-in XF:User\Avatar service for processing, resizing, and storage. Works with all configured storage adapters.
Social / connected account registration supported — The avatar field is injected into both the standard registration form and the connected account completion form.
Server-side validation — File type and image validity are checked on the server, not just the browser. Fake extensions won't sneak through.
100% native XenForo styling — Uses <xf:uploadrow /> — looks exactly like every other field on the registration page. No custom CSS required.
No admin options to misconfigure — The requirement is always on. Simple, intentional, reliable.
Clean install / uninstall — No database tables. Removes itself completely on uninstall.
Phrase-based — All user-facing text uses XenForo phrases, making translation straightforward.
How It WorksThe addon extends XF\Service\User\Registration via XenForo's native class extension system (XFCP). Two template modifications inject a native <xf:uploadrow /> field — marked required — into the registration form. If no valid image is submitted, a validation error is attached to the user entity and the form is rejected before the account is ever saved.
On successful registration, the avatar is processed and stored immediately using XenForo's own XF:User\Avatar service — the same one used everywhere else in the forum.
Requirements
XenForo 2.3.0 or later- PHP 8.0 or later
- No additional dependencies
Installation- Download Avatar.zip and extract it.
- Upload the contents of the upload/ folder to your XenForo root directory.
- In your Admin Control Panel, go to Add-ons → Install/Upgrade from File and select the zip.
- Click Install. That's it — the avatar requirement is immediately active.
