Here's how to integrate StopForumSpam with XenForo:
Step 1: Get Your StopForumSpam API Key
- Go to stopforumspam.com
- Click Register and create a free account
- After logging in, go to My Account → API Keys
- Click Add API Key, give it a label (e.g. "MyForum")
- Copy the generated API key
Step 2: Enter the API Key in XenForo
- Log into your XenForo Admin Control Panel (ACP)
- Go to Setup → Options → Spam Management
- Find the Stop Forum Spam section
- Paste your API key into the Stop Forum Spam API Key field
- Click Save
Step 3: Configure Spam Management Options
While in
Setup → Options → Spam Management, configure these settings:
Registration Checks
- Enable Check username against Stop Forum Spam — flags known spammer usernames
- Enable Check email against Stop Forum Spam — blocks disposable/known spam emails
- Enable Check IP against Stop Forum Spam — blocks IPs with spam history
Thresholds
XenForo lets you set what happens when a match is found:
| Action | When to use |
|---|
| Reject registration | High-confidence spam matches |
| Flag for moderation | Medium-confidence matches |
| Allow but moderate posts | Low-confidence, to avoid false positives |
A good starting config:
- Set frequency threshold to 2–3 (how many times the email/IP has been reported)
- Set confidence threshold to 75–80% for rejections
Step 4: Configure Spam Trigger Actions
Go to
Setup → Options → Spam Management → Spam Trigger Action:
- Reject — completely blocks the registration (best for obvious spam)
- Moderation — puts the user in a moderated state requiring admin approval
- Allow — lets them in but flags them for review
Recommended setup:
- High score matches → Reject
- Medium score matches → Moderation queue
Step 5: Set Up Banned Emails & IPs
While you're in the ACP, also configure:
- Setup → Banning → Banned Emails — add common disposable email domains:
- mailinator.com
- guerrillamail.com
- tempmail.com
- throwam.com
- yopmail.com
- Setup → Banning → Banned IP Addresses — manually ban repeat offender IPs
Step 6: Reporting Spam Back to StopForumSpam
This helps the community database grow — when you ban a spammer, report them back:
- In XenForo, when using the Spam Cleaner tool on a user:
- Check Submit to Stop Forum Spam before cleaning
- This submits their username, email, and IP to the SFS database automatically
- You can also manually submit via your SFS account dashboard
Step 7: Test the Integration
- Go to stopforumspam.com/lookup
- Enter a known spam email or IP to confirm it's in the database
- Try registering on your forum with that email — it should be blocked
- Check ACP → Logs → Spam Prevention Log to see what's being caught
Recommended Combined Setup
For maximum protection with minimal false positives:
reCAPTCHA v3 (score: 0.5)
+
StopForumSpam (frequency: 2+, confidence: 75%+)
+
Custom Q&A questions
+
New user post moderation (first 3–5 posts)
This layered approach stops the vast majority of bots at registration before they ever make a single post.