Troubleshooting

Find out why AI search filters are missing or the add-on will not install, and fix it by restarting the index rebuild or resolving the [ai] BBCode conflict.

• 1 · Search filters do not appear
• 2 · Installation is blocked
• 3 · A staff member cannot change a l...
• 4 · Report counts look low

Learn how to fix the missing template error when you export HTML widgets with Widgets Importer.

• 1 · The missing template error
• 2 · Check your version
• 3 · Update the add-on
• 4 · If the error remains

Use the diagnostic tool, allow rules and snapshots to check why a request was matched and correct the policy.

• 1 · Test an IP and user agent
• 2 · Add an allow rule
• 3 · Understand search-crawler protec...
• 4 · Check source health

Find out why the related topics list may not appear under an article, and how to check the usual causes.

• 1 · Check requirements
• 2 · Check the install
• 3 · Check the options
• 4 · Check the article

Find out why a Quoted by count is missing or different between visitors, and fix it with Quote Backlinks.

• 1 · Check the basics
• 2 · Permissions explain different co...
• 3 · Check what was quoted
• 4 · Run the rebuild again

Review the queue, provider health and failed attempts in the Admin CP so you can find why email is waiting or failing.

• 1 · Where to look
• 2 · Why mail is waiting
• 3 · Why mail failed or moved provide...
• 4 · Check the route

The add-on installed without errors but you cannot see it on the forum. Five checks that find the cause almost every time.

• 1 · 1. Nobody has permission yet
• 2 · 2. A setting has not been switch...
• 3 · 3. The widget has not been place...
• 4 · 4. Your style is hiding it

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.

• 1 · Two versions of the message
• 2 · Read the server error log
• 3 · What the common errors mean
• 4 · When the log is empty

A partly uploaded add-on causes strange errors. The file health check compares every file with what should be there.

• 1 · How the check works
• 2 · Run it from the Admin CP
• 3 · Run it from the command line
• 4 · Fixing what it finds

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.

• 1 · Find failed template modificatio...
• 2 · Fix a modification that does not...
• 3 · Outdated templates after an upda...
• 4 · After an add-on upgrade

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.

• 1 · First, test without any cache
• 2 · Cloudflare and other CDNs
• 3 · XenForo's page cache for guests
• 4 · New PHP files not taking effect

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.

• 1 · Signs you need this guide
• 2 · Step 1: switch off add-on code
• 3 · Step 2: disable the add-on causi...
• 4 · Step 3: remove the emergency lin...