🔍 Why Details Matter When Reporting Plugin Issues
When a WordPress plugin stops working correctly, the speed of resolution depends almost entirely on the information you provide upfront. Vague reports such as "the plugin is broken" make it difficult for our team to diagnose the problem, which leads to longer back-and-forth exchanges and slower fixes. This article walks you through exactly what to capture and how to report it effectively.
⚠️ Common Signs of a Critical Plugin Issue
Before reaching out, confirm you are experiencing one or more of the following:
- The Search Atlas WordPress plugin fails to install, activate, or update
- Data is not syncing between your WordPress site and the Search Atlas platform
- The plugin causes a white screen, fatal error, or site crash after activation
- Settings saved in the plugin are not being retained
- The plugin dashboard is blank, missing data, or displays an error message
- Conflict with another plugin or theme causes unexpected behavior
📋 Information to Gather Before Reporting
Collecting the right details before you contact support dramatically reduces resolution time. Please have the following ready:
- WordPress version: Found in your WordPress admin under Dashboard → Updates.
- Search Atlas plugin version: Found under Plugins → Installed Plugins. Note the version number listed beneath the plugin name.
- PHP version: Found under Tools → Site Health → Info → Server.
- Exact error message: Copy the full text of any error or warning displayed on screen. Do not paraphrase — the exact wording matters.
- Steps to reproduce: Write down the precise sequence of actions that trigger the issue (e.g., "I clicked Save Settings, then navigated to the Keyword Tracker tab, and the page went blank").
- When it started: Note the date and time the issue first appeared, and whether anything changed around that time (update, new plugin, hosting change).
- Screenshots or screen recordings: Visual evidence helps our team see exactly what you are seeing.
- Active plugins list: Go to Plugins → Installed Plugins and note which plugins are active. This helps identify conflicts.
- Hosting environment: The name of your hosting provider (e.g., WP Engine, SiteGround, Cloudways).
🧪 Quick Troubleshooting Steps to Try First
Before escalating, try these steps — they resolve the majority of plugin issues:
- Deactivate and reactivate the plugin: Go to Plugins → Installed Plugins, deactivate Search Atlas, then reactivate it.
- Update the plugin: Check for and install any available updates.
- Clear your cache: Clear both your WordPress site cache and your browser cache, then reload the page.
- Switch to a default theme: Temporarily switch to a default WordPress theme (e.g., Twenty Twenty-Four) to rule out a theme conflict.
- Disable other plugins temporarily: Deactivate all plugins except Search Atlas to check for a plugin conflict. Reactivate them one by one to identify the culprit.
- Check Site Health: Go to Tools → Site Health and review any critical issues flagged by WordPress.
🚀 How to Escalate Effectively
If the steps above do not resolve the issue, escalate immediately — but come prepared. When you open a support conversation, include everything from the checklist in the section above. The more specific you are, the faster our team can act. A report that says "After updating to plugin version 3.2.1 on WordPress 6.5, clicking the Sync button on the Content Planner page returns a 500 Internal Server Error. This started on June 10 and my host is WP Engine." will be prioritised and resolved far more quickly than a general report of something being broken.
⏱️ Understanding Escalation Timeouts
Our support team follows up on open issues within a set window. If a conversation is escalated as critical but no specific details are provided, the ticket may time out while our team waits for the information needed to investigate. To prevent this:
- Respond promptly to any follow-up questions from our team
- Include all required details in your very first message
- Mark your issue as critical only when it is causing site downtime or complete loss of plugin functionality
If your ticket has timed out and your issue is still unresolved, please reopen a conversation and include the full details outlined above.
💬 Contact Support
If you need further assistance, open the chat widget in the bottom-right corner of the platform and type human teammate to be connected with a member of our team.