ShopMind AI Docs

Troubleshooting

This page helps you solve the most common setup, connection, AI, licensing, and workflow issues in ShopMind AI. Start with the basics first, then work step by step toward the specific feature that is failing.

Start here first

Before troubleshooting a specific feature, confirm the basics:

  • WordPress is working normally;
  • WooCommerce is installed and active;
  • ShopMind AI is installed and activated;
  • your license is valid if using a paid version;
  • AI settings are saved correctly if required; and
  • there are no visible fatal errors, plugin conflicts, or blocked requests.

Problem: the plugin does not appear to work after activation

What to check

  • Confirm that activation completed successfully.
  • Refresh the WordPress admin page.
  • Check that the ShopMind AI menu appears in the sidebar.
  • Look for any PHP errors, admin notices, or white-screen behavior.
  • Temporarily disable recently installed plugins if a conflict is suspected.

Likely cause

The issue is often caused by an installation problem, plugin conflict, incomplete activation, or a server-side error.

Problem: WooCommerce is not detected

What to check

  • Make sure WooCommerce is installed and active.
  • Confirm that WooCommerce itself is functioning correctly.
  • Reload the admin after activating WooCommerce.
  • Check for plugin load-order issues or conflict messages.

Likely cause

ShopMind AI depends on WooCommerce context. If WooCommerce is inactive, broken, or not loaded correctly, related features may not be available.

Problem: license validation fails

What to check

  • Confirm that the license key is entered exactly as provided.
  • Save the settings again and retry validation.
  • Make sure your site can reach external services.
  • Check for firewall, DNS, or outbound request restrictions.
  • Review the plugin status or diagnostics page if available.

Likely cause

This is often caused by an incorrect key, temporary connection issue, expired license, or a blocked request from the hosting environment.

Problem: AI features return no output

What to check

  • Review AI settings and confirm they are saved.
  • Check that any required provider or connection details are valid.
  • Run a simple test on a product with good data.
  • Look for usage limits or plan restrictions.
  • Check whether the feature is available in your version.

Likely cause

The most common causes are missing configuration, unavailable AI connection, limited product data, or access restrictions related to plan or usage.

Problem: the output feels weak, generic, or inconsistent

What to check

  • Review the quality of the product title, description, and structured data.
  • Test with a product that has richer content.
  • Compare multiple products rather than over-focusing on one run.
  • Check whether AI behavior or detail settings can be adjusted.

Likely cause

AI-assisted output quality is strongly affected by the quality and completeness of the data being analyzed. Thin product content usually leads to thinner output.

Problem: a feature is missing or disabled

What to check

  • Check your version and plan level.
  • Confirm whether the feature requires licensing or AI setup.
  • Review the settings page for toggles or prerequisites.
  • Reload the admin after updating plan or license state.

Likely cause

Some features may be gated by version, plan, configuration, or usage state rather than being technically broken.

Problem: pricing, competitor, or commercial output seems unrealistic

What to check

  • Review the product data being analyzed.
  • Compare the result with your real margins, costs, and business logic.
  • Check whether the product has enough context to support a useful interpretation.
  • Look for repeated patterns across several products rather than relying on one result.

Likely cause

These features are AI-assisted decision support. Unrealistic output usually means the available context is incomplete, the product is unusual, or the result simply needs manual rejection.

Important troubleshooting note

ShopMind AI provides AI-assisted analysis and commercial guidance for decision support only. Output quality depends on product data, plugin configuration, connection status, feature availability, and context. Results may vary and should always be reviewed before use.

Best troubleshooting method

  1. Confirm the basics: plugin, WooCommerce, license, AI settings.
  2. Test one simple product with complete data.
  3. Check the plugin status, settings, and any validation tools.
  4. Disable likely conflicting plugins only if needed for testing.
  5. Compare behavior across more than one product.
  6. Contact support with clear details if the issue remains.

What to include when contacting support

  • your ShopMind AI version;
  • your WordPress and WooCommerce versions;
  • a short description of the problem;
  • screenshots if relevant;
  • the exact step where the issue happens; and
  • whether the issue affects one product or many.

The more specific you are, the easier it is to resolve the issue quickly.

Need direct help?

If the steps above do not solve the problem, send the details to support and include as much context as possible.