Troubleshooting

Get help fast: open a support ticket with the right details Beginner A ticket with the right details usually gets solved in one reply. What to include, where to find it, and when we answer. Licenses & Account · 3 min read · Updated Sep 27, 2026 › Find your XenForo, PHP and MySQL versions Beginner Three version numbers decide which add-ons you can run. Here is where to find each one, and what XenForo 2.2 and 2.3 need. Getting Started · 3 min read · Updated Sep 27, 2026 › Installed an add-on but nothing shows up? Beginner The add-on installed without errors but you cannot see it on the forum. Five checks that find the cause almost every time. Troubleshooting · 3 min read · Updated Sep 27, 2026 › "Oops! We ran into some problems": find the real error Beginner That message hides the real error from visitors. Here is where XenForo keeps the details, and what to send us so we can fix it fast. Troubleshooting · 4 min read · Updated Sep 27, 2026 › Use the file health check to find missing or changed files Beginner A partly uploaded add-on causes strange errors. The file health check compares every file with what should be there. Troubleshooting · 4 min read · Updated Sep 27, 2026 › Template modification errors and outdated templates Intermediate Add-ons change XenForo pages through template modifications. When a style has edited the same template, a modification can fail. How to spot and fix it. Troubleshooting · 4 min read · Updated Sep 27, 2026 › Changes not showing? Browser cache, Cloudflare and page caching Intermediate You changed a setting or upgraded an add-on, but the forum looks the same. Usually something is serving an old copy. Where to look. Troubleshooting · 4 min read · Updated Sep 27, 2026 › Site down after installing an add-on? Get back into the Admin CP Intermediate If an add-on takes the whole site down, one line in config.php gets you back in. The safe way to recover, step by step. Troubleshooting · 4 min read · Updated Sep 27, 2026 › Buttons or pop-ups not working: finding JavaScript errors Intermediate A button does nothing, an overlay never opens, a picker stays blank. These are JavaScript problems, and the browser console tells you which. Troubleshooting · 4 min read · Updated Sep 27, 2026 › Common add-on installation errors and how to fix them Intermediate The add-on is not in the list, requirements are not met, files have unexpected contents: the errors you are most likely to meet when installing, and the fix for... Troubleshooting · 4 min read · Updated Sep 27, 2026 ›