Frequently Asked Questions

Find answers to common questions about setting up and using AI Product Tools for WooCommerce. This guide covers everything from basic setup to advanced automation features.

General

What is AI Product Tools?

AI Product Tools is an all-in-one AI augmentation suite specifically designed for WooCommerce store owners. It helps you automate product content creation, SEO optimization, and customer support using advanced artificial intelligence models.

Do I need to have WooCommerce installed?

Yes, this plugin is built specifically for WooCommerce. It requires an active WooCommerce installation to function, as it interacts directly with your product catalog, categories, and attributes.

Do I need coding knowledge to use this plugin?

Absolutely not. The plugin is designed with a user-friendly interface that integrates directly into your WordPress admin dashboard. You can manage all AI generations, settings, and automations through simple buttons and menus.

Is my data secure?

Data security is our top priority. We do not store your product data on our servers; all processing happens between your server and the AI provider you choose.

How are my API keys protected?

Your AI provider API keys are stored in your WordPress database using AES-256-GCM encryption. This is an industry-standard encryption method that ensures your credentials remain safe even if your database is compromised.

Does this plugin work on shared hosting?

Yes, the plugin is optimized to work on most shared hosting environments. We use background processing and batching to ensure that AI tasks do not overload your server resources.

Can I use this on multiple sites?

If you have a multi-site license, you can use the plugin across all sites in your network. Each site can have its own settings and AI provider configurations.

Is the plugin translation-ready?

Yes, the plugin is fully translation-ready and follows WordPress internationalization standards. You can translate the admin interface into any language using tools like Loco Translate.

AI Providers

Which AI providers are supported?

The plugin currently supports four major AI providers: OpenAI (ChatGPT), Google Gemini, Anthropic Claude, and OpenRouter. This variety allows you to choose the provider that best fits your budget and quality requirements.

Can I switch between different AI providers?

Yes, you can switch your active AI provider at any time from the settings menu. The plugin will immediately start using the new provider for all subsequent generation tasks.

Are there free AI provider options?

Some providers like Google Gemini offer free tiers with certain usage limits. You can also use OpenRouter to access various free or low-cost models depending on their current availability.

What is the difference between the AI models?

Different models offer varying levels of creativity, speed, and cost. For example, GPT-4o is highly creative and accurate but more expensive, while GPT-3.5 Turbo is faster and more affordable for basic tasks.

What is OpenRouter?

OpenRouter is a unified API that gives you access to dozens of different AI models from various providers. It is a great way to experiment with different models without needing separate accounts for each one.

What are Temperature and Top P settings?

These are technical parameters that control the "creativity" of the AI. A higher temperature makes the output more diverse and creative, while a lower temperature makes it more focused and deterministic.

Credits and Plans

How do credits work in the plugin?

Credits are the internal currency used to track your usage of Advanced AI features. While the plugin itself is a tool, the advanced processing and automation features consume credits based on the complexity of the task.

What are the credit limits for different plans?

The Free version of the plugin includes 250 credits per month to help you get started. The Pro version increases this limit to 5,000 credits per month, allowing for much higher volume operations.

Does Standard mode use credits?

No, Standard mode is completely free and unlimited for all users. You can generate as many basic descriptions as you need without consuming any of your monthly credit balance.

Is single product generation free?

Yes, using the AI tools within the product edit page (metabox) does not consume credits. This allows you to perfect individual products manually without worrying about your credit balance.

How much does each action cost?

Credit costs vary depending on the action. For example, generating an advanced bulk description costs more than generating a simple SEO meta title. You can see the cost of each action in the dashboard.

When do my credits reset?

Your credit balance resets automatically every month on the anniversary of your installation or upgrade. Unused credits do not roll over to the next month.

Do credits expire?

Yes, credits are allocated on a monthly basis and expire at the end of each billing cycle. They do not accumulate, so it is best to use them within the month they are provided.

How can I check my current credit balance?

You can check your balance at any time from the Toolkit Dashboard or the plugin settings page. The balance is updated in real-time as you perform actions.

What happens if I run out of credits?

If you reach your monthly limit, Advanced features and Automation Jobs will be paused until your next reset date. However, you can still use Standard mode and single product generation without interruption.

Can I buy one-time credits?

Yes, if you need more credits before your monthly reset, you can purchase one-time credit top-up packs from your account dashboard to continue using Advanced features.

Content Generation

How does the AI know what to write about my products?

The AI analyzes the data you have already provided for your product, including the title, category, price, and any existing attributes or short descriptions. It uses this context to create relevant and accurate content.

Can I customize the writing style?

Yes, you can choose from various writing styles such as Professional, Creative, Persuasive, or Informative. This ensures the generated content matches your brand's unique voice.

Which languages are supported?

The plugin supports over 50 languages. You can generate content in your native language or translate your product catalog into multiple languages to reach a global audience.

Does the AI generate HTML or plain text?

You can choose between HTML and plain text output. HTML output is perfect for main product descriptions as it includes proper formatting like headings and lists, while plain text is often better for short descriptions.

Can I edit the content before it goes live?

Yes, especially in Advanced mode, the plugin creates a "Draft" or "Review" state. You can read and manually edit the AI-generated text before clicking the approve button to apply it to your product.

Does it support variable products?

Yes, the plugin can generate content for variable products. It can take into account the different variations and their specific attributes to create a comprehensive description for the main product.

Can I generate content for categories?

Currently, the plugin focuses on product-level content. However, you can use the generated product descriptions to help inform your category page content manually.

Single Product Generation

Where can I find the single product tools?

The single product tools are located in a metabox on the right-hand side (or bottom) of your WooCommerce product edit screen. It is always available whenever you are editing an individual product.

What are the four main generation buttons?

The metabox features four quick-action buttons: Title, Description, Short Description, and Tags. Each button triggers a specific AI task for that product instantly.

What is the "Pin" feature in the metabox?

The pin feature allows you to keep the AI metabox visible even when you scroll down the page. This makes it easy to access the tools while you are working on different parts of the product data.

Can I collapse the metabox?

Yes, if you need more screen space, you can collapse the metabox just like any other WordPress dashboard widget. Your settings and progress will be saved even when collapsed.

What happens if I click generate twice?

If you click generate again, the AI will create a new version of the content. You can then choose which version you prefer to keep for your product.

Do I need credits to use the metabox tools?

No, the single product generation tools in the metabox are free to use and do not consume your monthly credit balance.

Advanced Bulk Description Generator

What makes the Advanced generator different?

The Advanced Bulk Description Generator uses more sophisticated prompts and allows for high-quality HTML output. It is designed for store owners who want the best possible content for their products.

How does the approval workflow work?

When you run an advanced bulk generation, the results are saved to a "History" tab first. You can review each description, make edits, and then approve them individually or in bulk to update your products.

What is the History tab?

The History tab stores all your previous advanced generations. This allows you to go back and review or re-apply content that was generated in the past.

Can I use custom variables in my prompts?

Yes, the Advanced generator supports custom variables. You can insert placeholders for product data like [title], [price], or [sku] directly into your AI prompts to guide the generation process.

What is "Improve Existing" mode?

In this mode, the AI reads your current product description and tries to make it better by improving the flow, grammar, and persuasiveness while keeping the original information.

What is "Keep Existing" mode?

This mode tells the AI to generate new content but ensure that it incorporates all the key points from your current description, effectively expanding on what you already have.

Can I filter by stock status?

Yes, the bulk generator allows you to filter products by their stock status (In Stock, Out of Stock, On Backorder) so you can focus on the products that are currently available for sale.

Can I set a generation interval?

Yes, you can set a delay between each product generation. This is useful for managing server load and staying within the rate limits of your AI provider.

Standard Bulk Generator

Is the Standard Bulk Generator really free?

Yes, the Standard Bulk Generator is completely free and unlimited. It is designed for users who need to update many products quickly with straightforward, plain-text descriptions.

Does it have an approval queue?

No, the Standard generator applies the content directly to your products as soon as it is generated. This makes it the fastest way to fill out a large catalog.

What kind of output does it produce?

The Standard generator typically produces clean, plain-text descriptions. It is ideal for stores that prefer a simple and consistent look across all product pages.

Is it safe for SEO?

Yes, the content generated is unique and relevant to your products, which is great for SEO. It helps avoid duplicate content issues that can occur when using manufacturer-provided descriptions.

When should I use Standard instead of Advanced?

Use Standard mode when you have a very large number of products and need basic descriptions quickly. Use Advanced mode when you want high-quality, formatted content and want to review it before it goes live.

Bulk Title Generator

How does the Title Generator help with SEO?

The AI analyzes your product and generates titles that are both catchy for customers and optimized for search engines. It focuses on including relevant keywords while keeping the title within recommended lengths.

Can it update my product slugs?

Yes, you have the option to automatically update the product URL (slug) to match the new AI-generated title. This helps maintain consistency and improves SEO.

Can I choose the tone of the titles?

Yes, you can select different tones such as "Click-worthy," "Descriptive," or "Minimalist" to match your store's marketing strategy.

What are Title Variants?

Pro users can generate multiple title variants for each product. This allows you to see different options and choose the one that you think will perform best.

Does it support long-tail keywords?

Yes, the AI is excellent at identifying and incorporating long-tail keywords that potential customers might use when searching for specific products.

Can I provide target keywords?

Yes, you can input specific keywords that you want the AI to include in the generated titles. This is a powerful feature for targeted SEO campaigns.

SEO Meta Generator

Which SEO plugins are supported?

The plugin officially supports Yoast SEO, RankMath, All in One SEO (AIOSEO), SEOPress, and The SEO Framework. It detects these plugins automatically and writes the meta data directly into their fields.

What specific meta data can it generate?

The SEO Meta Generator can create the Meta Title, Meta Description, and the Focus Keyword for each product. This ensures your products are fully optimized for search engine results pages.

What is a focus keyword?

A focus keyword is the primary search term you want a product page to rank for. The AI identifies the most relevant term based on your product data and sets it in your SEO plugin.

Can I generate multiple variants?

Yes, you can generate multiple versions of meta titles and descriptions. This gives you the flexibility to choose the most compelling snippet for your search engine listing.

What data does the AI use for SEO?

The AI looks at your product title, description, categories, and tags to understand the most important keywords and selling points of your product.

FAQ Generator

Does it generate FAQs in HTML or plain text?

You can choose the format that best fits your theme. The FAQ generator supports both plain text and structured HTML (like lists or schema-ready formats).

How many FAQs can I generate per product?

You can set the generator to create anywhere from 1 to 10 frequently asked questions for each product, depending on how much detail you want to provide.

Can I use FAQs for schema markup?

Yes, if you choose the HTML format, you can easily wrap the generated FAQs in schema markup to help search engines understand and display them as rich snippets.

What are the "Append" and "Replace" modes?

"Append" mode adds the new FAQs to the end of your existing content, while "Replace" mode removes any old FAQs and starts fresh with the new AI-generated ones.

Where are the FAQs saved?

You can choose the target field for your FAQs. Most users save them to the main product description or a custom tab provided by their theme or a third-party plugin.

What is the status flow for FAQs?

FAQs follow a structured flow: they start as "Reviewing" (generated but not saved), move to "Staged" (ready to be applied), and finally "Applied" (saved to the product).

Automation Jobs

Is Automation available for everyone?

Automation Jobs are a Pro-only feature. They are designed for growing stores that need to keep their content updated without manual intervention.

What kind of scheduling options are available?

You can schedule jobs to run hourly, twice daily, daily, or weekly. You can also trigger them manually whenever you need to process a specific batch of products.

Can I filter which products are automated?

Yes, you can create filters based on product categories, tags, stock status, or even specific date ranges. This allows you to automate only the products that need attention.

How does the draft review workflow work in automation?

Even with automation, you can choose to have the generated content saved as a draft first. You will receive a notification to review and approve the content before it is published to your live site.

How do I see the logs?

Each automation job has a detailed log section where you can see exactly which products were processed, any errors that occurred, and the overall success rate of the job.

What are the different job statuses?

Jobs can be "Pending" (waiting to start), "Running" (currently processing), "Paused" (stopped by the user), "Completed" (finished successfully), or "Failed" (encountered an error).

Is there a limit to concurrent jobs?

To ensure server stability, the system limits the number of concurrent jobs to 3. Other jobs will wait in the queue until a slot becomes available.

What happens if a job gets stuck?

The plugin includes a stuck job recovery system. If a job hasn't shown progress for 30 minutes, the system will automatically attempt to restart it or log an error for your attention.

AI Shop Assistant / Chatbot

Does the chatbot require the Store Index?

Yes, the AI Shop Assistant relies entirely on the Store Index to understand your products. Without a built index, the chatbot will not be able to answer specific questions about your catalog.

What are the 6 settings tabs for the chatbot?

The chatbot configuration is divided into 6 tabs: General, Appearance, Behavior, Pre-chat Form, WhatsApp, and Advanced. This allows for deep customization of every aspect of the assistant.

Can the chatbot show product cards?

Yes, when the assistant recommends a product, it can display a rich product card with an image, price, and a "View Product" button, making it easy for customers to shop.

Can I change the chat icon?

Yes, you can upload your own custom icon or choose from a library of pre-set icons to match your store's design and personality.

What is the Pre-chat Form?

The pre-chat form allows you to collect customer information like name and email before the chat begins. This is great for lead generation and providing personalized support.

How does WhatsApp escalation work?

If the AI cannot answer a question or if the customer prefers human contact, you can provide a WhatsApp button that allows them to jump directly into a conversation with your support team.

Can I change where the chatbot appears?

Yes, you can choose to show the chatbot on all pages, only on product pages, or exclude it from specific areas of your site like the checkout or cart pages.

Does it detect the customer's language?

Yes, the chatbot features auto-language detection. It will respond to the customer in the same language they use to ask their question.

How does the message queue work?

If your AI provider is slow or hits a rate limit, the chatbot uses a message queue to ensure that no customer requests are lost. It will process the messages as quickly as possible.

Does the chatbot use credits?

Yes, each message processed by the AI Shop Assistant consumes a small amount of credits. This covers the cost of the AI processing required to understand and answer the customer's query.

Store Index

What is the TOON format?

TOON is our proprietary, token-efficient data format. It compresses your product information so that the AI can "read" your entire catalog without consuming excessive tokens or slowing down the chat.

What is sharding in the Store Index?

For very large stores, the index is split into smaller "shards." This allows the chatbot to load only the relevant parts of your catalog, improving response times and reducing memory usage.

What is the map.toon.gz file?

This is a central mapping file that helps the system keep track of which products are in which shards. It is essential for the quick retrieval of product data during a chat.

What is the difference between Basic and Advanced view?

Basic view shows you the essential status of your index, while Advanced view allows you to see the technical details of the shards, file sizes, and last update timestamps.

How do Profiles work?

Profiles allow you to create different versions of your index. For example, you could have one profile for your public chatbot and another for an internal tool, each containing different sets of products.

Can I choose which fields are indexed?

Yes, you can select exactly which product fields (title, description, price, attributes, etc.) are included in the index. This helps you control what information the AI has access to.

What is the difference between Incremental and Force Rebuild?

An Incremental rebuild only updates products that have changed since the last index, which is much faster. A Force Rebuild deletes the old index and creates a completely new one from scratch.

Can I schedule automatic rebuilds?

Yes, you can schedule the index to rebuild automatically at specific intervals (e.g., every night). This ensures your chatbot always has up-to-date information about prices and stock levels.

Does indexing use credits?

No, building and maintaining the Store Index does not consume any credits. It is a local process that prepares your data for the AI.

Custom Variables

What are Custom Variables?

Custom Variables are placeholders you can use in your AI prompts. When the AI runs, it replaces these placeholders with actual data from the product it is currently processing.

How do I create my own variables?

You can create custom variables in the settings by mapping them to specific WordPress meta keys or WooCommerce fields. This is perfect for including data from other plugins.

What are the built-in variables?

The plugin comes with several built-in variables including [title], [category], [price], [regular_price], [sale_price], [sku], [attributes], and [short_description].

Can I use math in variables?

Currently, variables are used for direct data replacement. If you need to perform calculations, it is best to do so in a custom field first and then map that field to a variable.

Does it support Advanced Custom Fields (ACF)?

Yes, you can easily map ACF fields to custom variables. This allows the AI to use any custom data you have added to your products in its generation process.

Can I use variables from third-party plugins?

As long as the third-party plugin stores its data in the standard WordPress meta table, you can create a custom variable to access and use that data in your prompts.

Performance

Will this plugin slow down my website?

No, the plugin is designed to have zero impact on your website's frontend performance. All AI processing and admin tools are only loaded when you are logged in as an administrator.

Does it load scripts on every page?

No, the plugin only enqueues its scripts and styles on the specific admin pages where they are needed, such as the product edit screen and the AI Product Tools dashboard.

Does it use a lot of database space?

The plugin is very efficient with database usage. It only stores the necessary settings, generation history, and the compressed Store Index, which is designed to be as small as possible.

What are the server requirements?

The plugin requires PHP 7.4 or higher and a standard WordPress environment. It works best on servers with at least 256MB of PHP memory, especially when running large bulk operations.

Compatibility

Which versions of WordPress and WooCommerce are required?

The plugin requires WordPress 5.0 or higher and WooCommerce 6.0 or higher. We always recommend staying updated to the latest versions for the best security and performance.

Is it compatible with Multi-site?

Yes, the plugin is fully compatible with WordPress Multi-site installations. You can activate it on a per-site basis or network-activate it.

Does it work with custom product types?

Yes, the plugin works with most custom product types as long as they follow the standard WooCommerce product structure. This includes subscriptions, bundles, and composite products.

Does it work with WPML or Polylang?

Yes, the plugin is compatible with popular translation plugins like WPML and Polylang. It can detect the language of the product and generate content accordingly.

Billing

How is billing handled?

All billing and license management are handled securely through the Freemius platform. We do not store your credit card information on our servers.

Can I cancel my subscription at any time?

Yes, you can cancel your Pro subscription at any time from your account dashboard. You will retain access to all Pro features until the end of your current billing cycle.

Is there a refund policy?

Yes, we offer a satisfaction guarantee. If you are not happy with the plugin, you can request a refund within the first 14 days of your purchase through our support channel.

Are AI provider costs included?

No, the costs for using AI providers like OpenAI or Anthropic are separate from the plugin subscription. You will need your own API key and will be billed by the provider based on your usage.

What's Next?

Now that you've explored the frequently asked questions, you might want to dive deeper into specific topics:

• Troubleshooting: If you're encountering issues, check our /docs/support-resources/troubleshooting guide.
• Best Practices: Learn how to get the most out of the AI in our /docs/support-resources/tips-and-best-practices section.
• Get Support: Still have questions? Reach out to us at /docs/support.