The Report an Issue feature in the Search Atlas WordPress plugin provides a simple, streamlined way for clients to notify our team of problems they encounter. In a few simple steps, users can include a full issue description, select the severity, and automatically attach all relevant system information we need to debug and prioritize the issue efficiently. This ensures faster troubleshooting and better visibility for the engineering team.
📌 Plugin version requirement: The Report an Issue feature requires the latest version of the Search Atlas WordPress plugin. Before submitting a report, please make sure your plugin is updated to the most recent release to ensure the feature functions correctly and to avoid known connectivity issues present in older versions.
🖥️ Step-by-Step Guide
🔧 Step 1 — Navigate to the Report a Bug Section
From your WordPress dashboard, click the More Features (apps-grid icon), then select Report a Bug.
Your screen will load the full reporting interface, displaying two major areas:
- System Information
- Report an Issue
This system information is automatically included in your report to help our team debug your environment.
📝 Step 2 — Review the System Information Block
Under the “System Information” section, you’ll see key details about your installation:
- Website URL
- Plugin version
- WordPress version
- PHP version
- Active theme
- Project UUID — a unique identifier for your Search Atlas workspace, used by our team to locate your account quickly.
This data requires no action from you — it is collected automatically and securely.
🗒️ Step 3 — Enter Your Issue Description
Below the System Information block, you will find the Issue Description text area. If you do not see it, scroll down past the system details panel.
Here, you’ll describe:
- What happened
- Any error messages
- Steps to reproduce the issue
- Any relevant context
⚠️ The field requires at least 10 characters.
If the field is empty and you try to proceed, it will show a validation warning — exactly: "Issue description must be at least 10 characters long" — and the form will not submit until the minimum is met.
🚦 Step 4 — Select the Severity Level
Below the description field, choose the issue severity. Choose the level that best matches the impact of the problem:
- Critical — site is down, data loss is occurring, or the plugin is completely unusable.
- High — a major feature is broken or significantly impacting your workflow.
- Medium — functionality is impaired but a workaround exists.
- Low — cosmetic, minor, or non-blocking issue.
Selecting the right severity helps our engineering team triage and prioritize your report appropriately.
👤 Step 5 — Include User Information
You’ll see a checkbox labeled:
Include current user information (username, email)
This helps us contact you if more context is needed.
📤 Step 6 — Submit Your Report
Click the Submit Report button.
Once submitted:
- The plugin bundles your system data,
- Attaches your description, severity, and user info,
- Sends everything directly to our monitoring dashboard,
- And becomes available to the engineering team for triage.
After submission, you will see an on-screen confirmation message indicating that your report was received successfully. If you opted to include your user information, our team may follow up by email with any additional questions or updates as the issue is investigated.
📌This ensures we can prioritize and debug issues properly.
💡 How It Works Behind the Scenes
Once your report is submitted:
- The issue appears automatically in our internal dashboard.
- Our engineering team can see full environment details and debug context.
- Each issue is tracked, organized, and prioritized for investigation.
This makes the process fast, transparent, and reliable for both the user and the development team.
⚠️ Troubleshooting: If the Report Issue page does not load, throws an error, or the plugin appears to be in an unhealthy state, please contact our support team directly through your usual support channel and include your Website URL, plugin version, and a manual description of the issue so we can assist you right away.
✨ Final Notes
The Report an Issue tool is designed to make communicating technical issues frictionless. Just describe what you experienced, choose a severity, and click submit, the plugin handles the rest, giving our team everything needed to investigate. If you ever need help or want to share more details, don’t hesitate to reach out. We’re here to support you!