WooNinjas FAQ and Schema Generator is a WooCommerce plugin that writes product FAQs for you with AI. It reads your product details and creates the question and answer pairs your customers would ask before they buy.
You can generate FAQs for a single product or for your whole catalog in one bulk job. Every job runs in the background, so large catalogs won’t time out your server. The plugin also creates Google FAQPage schema (JSON-LD) for each product, so search engines can read your FAQs as structured data.
This article covers how to set up the plugin, generate FAQs, add schema, and manage everything from one place.
Installation
- Install the WooCommerce plugin first & then activate it.
- Then, install the WordPress FAQ Generator plugin & activate it.
- After activation, the plugin’s menu will appear in your dashboard.
- Go to the Settings & APIs tab and add an API key for Claude or OpenAI. The plugin can’t generate FAQs without an API key.

Dashboard
The Dashboard gives you a quick overview of FAQ and schema coverage across your store.

Active FAQ Coverage
Shows how many products have FAQs and what percentage of your catalog that covers.
Total FAQ Pairs Generated
Shows the total number of question and answer pairs available across your store.
Active Store Schema
Shows how many products have FAQPage JSON-LD schema added.
Store Catalog FAQ & Schema Distribution
This bar splits your catalog into three groups:
- Both FAQs & Schema Active: products that have FAQs and schema.
- FAQs Only (No Schema): products that have FAQs but no schema yet.
- No FAQs Yet: products with no FAQs.
The total number of WooCommerce products in your store shows on the right side of this section.
Note: Products in the “FAQs Only (No Schema)” group don’t show FAQs on the frontend yet. Add schema to these products to make their FAQs visible.
Recent Products With FAQs
Lists the latest products that have FAQs, along with their FAQ pair count and schema status. Click on “View FAQs” to open a product’s FAQs, or click on “View In Catalog” to see your full product catalog.
Recent Generation Jobs
Lists the latest generation jobs with their job ID, progress, and status. Click on the eye icon to see a job’s details. Click on “New Job” to start a new generation job.
Note: The “New Bulk Job” button at the top right is available on every tab of the plugin.
Bulk Generate FAQs
Go to the “Bulk Generate” tab. Here you can pick products from your catalog and generate FAQs for them in bulk.

Find & Select Products
Search
Search your products by title or SKU.
Filters
Narrow down the product list with the category, stock status, and product dropdowns on the right.
Catalog Products
This table lists your products with their name, SKU, category, and FAQ status. Each product shows one or more of these status badges:
- No FAQs: the product has no FAQs yet.
- FAQs count (e.g., 5 FAQs): the number of FAQ pairs the product has.
- No Schema: the product has FAQs, but no schema is added yet.
- Schema Active: the product has FAQs and schema, so its FAQs show on the frontend.
Products that have FAQs also show a “View FAQs” button in the Actions column. Use the Previous and Next buttons at the bottom of the table to move between pages.
Tick the checkbox next to a product to select it. The selection bar above the table shows how many products you’ve selected.

Select Current Page
Selects every product on the current page. Once you select a page, this button changes to “Deselect Page.”
Select All Matching
Selects every product that matches your current search and filters, across all pages.
Clear Selection
Removes all selected products.
Generate Schema
Generates schema for your selected products. You can also select bulk products to generate FAQs(All Products).”

Generation Parameters
Questions Per Product
Enter how many FAQ pairs you want for each product. There’s no limit.
Skip products that already have FAQs
When this option is ticked, the plugin skips selected products that already have FAQs.
The generate button changes based on your selection:
- Select Products to Start: no products are selected yet.
- Generate for [number] Products: products are selected and ready to go.
- Generate More ([number]): shows when “Skip products that already have FAQs” is unticked. Use it to add more FAQs to products that already have them.

Start a Generation Job
- Go to the “Bulk Generate” tab.
- Search, filter, and tick the products you want FAQs for.
- Enter the number of FAQs in “Questions Per Product.”
- Tick or untick “Skip products that already have FAQs.”
- Click on the “Generate for [number] Products” button.
- A confirmation popup shows the products targeted, questions per product, and the active AI model. Click on “Confirm.”

The job runs in the background through Action Scheduler. You can track its progress on the “Job History” tab.
Note: A product needs at least 40 words of product information to generate FAQs. If a product has fewer than 40 words, the plugin won’t generate FAQs for it, and the job shows a “Failed” status with an “Insufficient Product Information” error.
Important: Generating FAQs isn’t the last step. FAQs won’t show on the product page until you generate the schema and add it to that product. See the “Generate & Add FAQ Schema” section below.
Job History
Go to the “Job History” tab to track every generation job and check its logs.

Total Jobs
Shows the total number of recorded generation jobs.
Active / Queued
Shows how many jobs are running or waiting in the queue.
Completed Runs
Shows how many jobs finished successfully.
Processed Products
Shows the total number of products processed across all jobs.
Each job card shows the job number, creation time, AI model, status, and a progress bar. Click on “Refresh Status” at the top right to update the job list.
Job Details & Logs
Click on “View Details & Logs” on any job card. A popup opens with:
- Job Summary: status, AI model, completed and failed product counts, and tokens used.
- Execution Logs Stream: a time-stamped log of everything that happened during the job.
- Batch Products Breakdown: each product in the job with its status, diagnostic details, and tokens used.
Click on “Download Full CSV Log” to save the job log as a CSV file.

Failed Jobs
If a product fails, the job card shows a “Failed” badge, the number of failed items, and the last error message.
The most common error is “Insufficient Product Information.” This means the product has fewer than 40 words of product information. Add more details to the product, then click on “Retry Failed Items” to run it again.

View & Edit FAQs
Once a job completes, the product shows up in “Recent Products With FAQs” on the Dashboard. At this point, its schema status is “No Schema,” so the FAQs aren’t visible on the frontend yet.

Click on “View FAQs” to open the product’s FAQs. You can open the same popup from the Bulk Generate tab.

Edit
Click on “Edit” to change a question or answer. Click on “Save Changes” to keep your edits, or “Cancel” to discard them.

Delete
Click on the red trash icon to delete an FAQ.
Regenerate FAQs
Runs FAQ generation again for this product.
Generate FAQ Schema
Creates the FAQPage schema for this product. See the next section.
Note: Once the schema is active, the popup header shows “Schema Active,” and each FAQ gets a “Schema” button next to “Edit.”
Generate & Add FAQ Schema
This step is required. Your FAQs won’t show on the product page until you generate the schema and add it to the product.
- Click on “View FAQs” for the product.
- Click on the “Generate FAQ Schema” button.
- Review the Google FAQPage schema. It includes all of the product’s FAQs.
- Click on the “Add Schema” button.
The schema popup also gives you these options:
- Copy Code: copies the schema code.
- Validate: checks the schema code.
- Test on Google: opens Google’s testing tool to test the schema.
- Back to FAQs: takes you back to the product’s FAQ list.

After you add the schema, the product status changes from “No Schema” to “Schema Active.” The product’s FAQs now show on the frontend.

FAQs on the Product Page
Once the schema is added, the product’s FAQs show on the product page as an accordion under “Frequently Asked Questions.” In this example, they show in a separate “FAQs” tab next to Description and Reviews.

The plugin also adds the FAQPage JSON-LD schema to the product page’s source code, inside a <script type=”application/ld+json”> tag.

You can change where FAQs appear on the product page from Settings & APIs ➔ Storefront Display & Schema.
Settings & APIs
Here you can connect your AI engine and change how the plugin generates and displays FAQs. Click on “Save All Settings” after making changes on any tab.
Claude AI Engine

Anthropic Claude API Key
Enter your API key from Anthropic Console ➔ Settings ➔ API Keys, then click on “Save & Test Connection.” The plugin stores your key encrypted (AES-256-CBC) in your WordPress database. Once the key is saved, a “Key Configured” badge shows at the top right.
AI Model Selection
Choose the Claude model the plugin uses to generate FAQs. Claude Sonnet 4.6 is the recommended option.
Default FAQs Per Product
Choose how many FAQs the plugin creates per product by default:
- 3 FAQs per product (Fastest)
- 5 FAQs per product (Default, Best Balance)
- 8 FAQs per product (Detailed Coverage)
- 10 FAQs per product (Maximum Depth)
OpenAI Engine

OpenAI API Key
Enter your secret key from OpenAI Platform ➔ API Keys, then click on “Save & Test Connection.” Until you add a key, the tab shows a “Missing API Key” badge.
AI Model Selection
Choose the OpenAI model the plugin uses to generate FAQs:
- GPT-4o Mini: fast and highly responsive.
- GPT-4o: high performance multimodal model.
Default FAQs Per Product
Works the same as the option on the Claude AI Engine tab.
Generation Defaults

Skip products that already have approved FAQs
Prevents duplicate FAQ generation during full-store runs, unless you target those products directly.
Auto-publish generated FAQs immediately
Skips the manual review step and publishes generated FAQs on the product pages right away.
Storefront Display & Schema

Single Product Display Hook
Choose where the FAQ accordion shows on your WooCommerce product pages:
- After Description / Reviews Tabs
- Above Tabs (Between Summary & Description)
- New Tab (Alongside Description & Reviews)
- Inside Right Column (Below Buy / SKU)
- Don’t Show on Frontend (Disabled)

Display Hook Priority
Sets the WordPress action priority for the FAQ section. A lower number runs earlier on the page. Default: 20.
Disable JSON-LD Schema.org FAQPage output
Turns off the <script type=”application/ld+json”> schema output on single product pages.
Data & System Storage

Custom System Prompt Additions
Edit the prompt the plugin sends to the AI engine. The prompt uses template variables like {product_title} and {attributes}, which the plugin replaces with each product’s details. Leave this field empty to use the standard prompt.
Rate Limit (Requests per minute)
Sets the maximum number of API requests per minute. This protects you from API rate limits and throttling. Default: 20.
Enable diagnostic queue logging
Stores raw Action Scheduler batch logs for troubleshooting.
Delete all plugin tables and FAQs upon uninstall
Removes all plugin data when you delete the plugin.
Note: Deleting plugin data is irreversible. Only enable this option if you want to remove all FAQs and plugin tables permanently.
FAQ’s
1- Why aren’t my FAQs showing on the product page?
FAQs only show on the frontend after you generate the schema and add it to the product. Open “View FAQs,” click on “Generate FAQ Schema,” then click on “Add Schema.” Also check that the Single Product Display Hook isn’t set to “Don’t Show on Frontend (Disabled).”
2- Why did FAQ generation fail for a product?
The product has fewer than 40 words of product information. Add more details to the product, then click on “Retry Failed Items” on the Job History tab.
3- Which AI engines does the plugin support?
The plugin supports Claude (Anthropic) and OpenAI. You need an API key for the engine you want to use.
4- How many FAQs can I generate per product?
There’s no limit. Enter any number in “Questions Per Product” on the Bulk Generate tab.
5- Can I add more FAQs to a product that already has FAQs?
Yes. Untick “Skip products that already have FAQs,” select the product, and click on “Generate More.”
6- Can I edit the generated FAQs?
Yes. Click on “View FAQs” for the product, then click on “Edit” next to any FAQ.
7- Will bulk generation time out my server?
No. The plugin runs generation in the background in chunks through Action Scheduler, so large jobs don’t hit server timeouts.
Changelogs
1.0.0
- Initial release.