Troubleshooting Guide

This is usually caused by one of three things:

• Typo: Please double-check that you have copied and pasted the entire key correctly, with no extra spaces.
• Caching: Your site might have a cached version of the settings page. Please clear your website's cache (e.g., WP Rocket, LiteSpeed) and your browser cache, then try again.
• Domain Binding: If you have moved your site from a staging or previous domain, your license might still be bound to the old URL. Go to Settings > AI Snippets PRO > Domain Binding and click "Clear Diagnostics" and "Save Changes", then try activating again.

This typically indicates a JavaScript conflict on the post editor screen. Another plugin or your theme might be loading a script that interferes with ours.

How to test for a conflict:

1. Temporarily switch to a default WordPress theme (like Twenty Twenty-Four).
2. Deactivate all other plugins except for AI Snippets & Schema PRO.
3. Check if the "Generate" button works. If it does, reactivate your plugins one by one, checking after each activation, until the button breaks again. The last plugin you activated is the source of the conflict.

Please let us know which plugin is causing the conflict so we can investigate a solution.

This error means your website's server was unable to communicate with our secure API to process the content. The most common causes are:

• Server Firewall: Your web host's firewall might be blocking outgoing connections. Please ask your host to whitelist connections to api.aisnippetspro.com.
• Outdated cURL or OpenSSL: Your server needs up-to-date software to make secure connections. Please contact your host and ask them to ensure your PHP cURL and OpenSSL extensions are current.
• Run Diagnostics: Go to Settings > AI Snippets PRO > Diagnostics and click "Run Ping / Usage / Diag". This can often provide more specific information about the connection failure.

This can be alarming, but it's usually a caching or timing issue.

• Clear All Caches: This is the most important step. You must clear your WordPress plugin cache (e.g., WP Rocket, W3 Total Cache), any server-level cache (often found in your hosting control panel), and your CDN cache (like Cloudflare) if you use one.
• Check for Conflicts: Ensure your SEO plugin isn't also trying to output FAQ or Article schema for the same page, which can cause validation errors. Our plugin is designed to work alongside them, but misconfiguration can cause problems.
• Wait for Google: It can take anywhere from a few hours to several days for Google to re-crawl your page and recognize the new structured data.

The quality of the AI's output depends heavily on the quality and length of your input content.

• Content Length: The plugin works best on well-developed articles. If your post is very short (e.g., under 300 words), the AI may not have enough context to generate a meaningful answer or relevant FAQs.
• Content Clarity: Ensure your post is well-structured with clear headings and paragraphs. A confusing or poorly written article will likely result in a confusing output.
• Content Focus: If the generated FAQs seem off-topic, it may be because your article covers too many different subjects. Try to keep each post focused on a single, core topic.

Our quotas operate on a rolling 30-day basis, not a calendar month. If your usage seems incorrect, the first step is always to use the diagnostic tool.

• Go to Settings > AI Snippets PRO > Diagnostics.
• Click the "Force Update Check" button at the top, then click "Run Ping / Usage / Diag".
• This syncs your site with our server and provides the most up-to-date information on your usage and when your next quota block becomes available. If it still seems wrong after a forced check, please contact support.

By default, the AI Snippets meta box appears on standard Posts and Pages. If you are using a Custom Post Type (CPT), you may need to ensure it's configured to support custom fields (the meta box).

• When you register your CPT (usually in your theme's functions.php file or a separate plugin), ensure the 'supports' array includes 'custom-fields'.
• If you are using a plugin like Custom Post Type UI (CPT UI), find your post type, edit it, and ensure that "Custom Fields" is checked under the "Supports" section.