Frequently Asked Questions (FAQ)

Time to complete: 5-10 minutes to find answers to your questions You'll learn: How to quickly navigate the FAQ, find specific answers, and solve common issues

Find instant answers to the most common questions about AI Product Tools. Organized by topic for quick navigation, with detailed explanations and links to comprehensive guides.

Quick Start: Find Your Answer Fast

Step 1: Identify Your Topic

Choose the category that best matches your question:

1. Getting Started - Installation, setup, API keys, first generation
2. Features & Usage - Bulk generation, custom fields, automation, settings
3. Pricing & Credits - Plans, credit system, billing, API costs
4. Content Quality - Improving output, customization, brand voice
5. Technical Issues - Errors, performance, compatibility, troubleshooting

Step 2: Scan Question Headers

Look through the relevant section below for questions matching yours:

• Questions are organized from basic to advanced
• Use your browser's Find function (Ctrl+F / Cmd+F) to search keywords
• Check "Related" links at the end of each section for deeper dives

Step 3: Review Complete Answer

Read the full answer including:

• Main explanation with key details
• Callout boxes highlighting important notes
• Related documentation links for comprehensive guides
• Code examples or screenshots where applicable

Step 4: Explore Related Topics

If your question isn't fully answered:

1. Check "Related Topics" cards at the bottom of this page
2. Visit linked documentation guides for detailed information
3. Use the search function in the documentation site header
4. Contact support if you still need help

Getting Started

What is AI Product Tools?

AI Product Tools is a WordPress plugin that uses artificial intelligence (OpenAI, Google Gemini, or OpenRouter) to automatically generate product descriptions, titles, and tags for WooCommerce stores. It features both unlimited bulk generation and advanced customization options for businesses of all sizes.

Key capabilities:

• Generate descriptions, short descriptions, titles, and tags
• Bulk processing for 10-500+ products
• Custom field mapping and variables
• Multiple AI model support (GPT-4o, o1, o3, Gemini 3 Pro, 100+ OpenRouter models)
• Automation scheduling (Pro feature)

Best for: E-commerce store owners, product managers, and content teams managing WooCommerce catalogs.

Do I need technical knowledge to use this plugin?

No technical knowledge required for basic usage. The plugin is designed for users of all skill levels:

✅ Non-technical users can:

• Use the setup wizard for guided configuration
• Generate content with single-click actions
• Apply standard settings and prompts
• Use the Enhanced Metabox for individual products
• Run bulk generation with default settings

🔧 Technical users can:

• Customize prompt templates with variables
• Map custom fields (ACF, WooCommerce meta)
• Use REST API for external integrations
• Configure automation jobs with filters
• Build custom workflows with developer tools

Related: Quick Start Guide shows first generation in 5 minutes, no technical knowledge needed.

What are the system requirements?

Minimum requirements:

Recommended configuration:

• PHP: 8.1 or higher
• Memory: 256MB or higher
• Max Execution Time: 300 seconds for large bulk operations
• WP-Cron: Enabled (required for automation jobs)

Check your configuration: Navigate to WordPress → Tools → Site Health → Info tab to view current PHP/WordPress versions.

Related: Installation Guide includes system compatibility checks.

Do I need WooCommerce?

Yes, WooCommerce is required. AI Product Tools is specifically designed for WooCommerce product management and will not activate without WooCommerce installed and active.

Why WooCommerce is required:

• Plugin hooks into WooCommerce product data structure
• Uses WooCommerce custom fields, attributes, and taxonomies
• Integrates with WooCommerce product editor
• Accesses product categories, tags, and meta data
• Applies generated content through WooCommerce APIs

If you don't have WooCommerce:

1. Install WooCommerce plugin from WordPress.org
2. Complete WooCommerce setup wizard
3. Add at least one product to your store
4. Then activate AI Product Tools

Related: Installation Guide walks through WooCommerce setup.

How do I get an API key?

Step-by-step instructions by provider:

For OpenAI:

1. Visit platform.openai.com
2. Sign up or log in to your account
3. Set up billing → Billing → Add payment method (required even for free trial)
4. Navigate to API keys section → API Keys
5. Click "Create new secret key"
6. Copy the key immediately (starts with sk-proj- or sk-)
7. Store securely - you won't see it again

For Google Gemini:

1. Visit aistudio.google.com
2. Sign in with Google account
3. Click "Get API key" button
4. Create API key (or select existing project)
5. Copy the key (starts with AIza)
6. Store securely

For OpenRouter:

1. Visit openrouter.ai
2. Sign up using Google/GitHub or email
3. Navigate to Keys section
4. Click "Create Key"
5. Copy the key (starts with sk-or-v1-)
6. Store securely

Cost comparison:

• OpenAI: Paid (free trial $5-18 credits, ~500-2500 product descriptions)
• Gemini: Free tier available (1500 requests/day)
• OpenRouter: Free tier available (qwen/qwen3-8b:free model)

Related: API Provider Setup has detailed guides with screenshots for each provider.

Can I test before committing to a paid plan?

Yes, multiple ways to test risk-free:

1. Use Free Tier AI Models:

• OpenRouter free tier: qwen/qwen3-8b:free model (no credit card needed)
• Gemini free tier: 1500 requests/day at no cost
• OpenAI trial credits: $5-18 free credits for new accounts

2. Test with Single Product:

• Use Enhanced Metabox to generate for 1-2 products
• Review quality before bulk operations
• No credit commitment required

3. Start with Standard Bulk Generator:

• Unlimited generations (no credit system)
• Test with 10-50 products
• Evaluate content quality at scale

4. Use Pro 14-Day Trial (if available):

• Access all Pro features temporarily
• Test automation jobs
• Evaluate advanced customization

Recommended testing workflow:

1. Day 1: Setup with OpenRouter free tier, test single product (5 minutes)
2. Day 2-3: Test Standard Bulk Generator with 25 products (1 hour)
3. Day 4-7: Customize prompts and test quality improvements
4. Day 8+: Decide on paid plan based on results

Related: Quick Start Guide shows first generation in 5 minutes.

Features & Usage

What's the difference between Standard and Advanced Bulk Generator?

Choose Standard when:

• Processing large catalogs quickly (50-500 products)
• Products have basic WooCommerce data (title, category, price)
• Speed is more important than customization
• You don't need HTML formatting in descriptions
• Working with simple product catalogs

Choose Advanced when:

• Products have extensive custom fields (brand, warranty, specifications)
• You need custom variable mapping (ACF fields, attributes, meta)
• HTML formatting required (lists, bold, links)
• Review/approval workflow needed before applying
• Fine-grained control over content quality

Can I use both? Yes! Use Standard for bulk catalogs and Advanced for premium products or complex custom field mapping.

Related: Bulk Generation Guide compares both modes in detail.

Can I customize the generated content?

Yes, extensive customization options available:

1. Prompt Customization:

• Customize system prompt (AI role and behavior)
• Customize user prompt templates (specific instructions)
• Include brand voice guidelines
• Add industry-specific terminology
• Set tone and style preferences

Example custom system prompt:

You are a professional electronics product copywriter specializing
in technical specifications and feature-focused descriptions.
Write detailed, accurate content highlighting key specs and benefits
for tech-savvy consumers. Use industry-standard terminology.

2. Variable Mapping:

• Use built-in variables: `{title}`, `{category}`, `{price}`, `{attributes}`
• Map custom fields to variables: `{brand}`, `{warranty_years}`, `{pa_resolution}`
• Create unlimited custom variables (Advanced mode)
• Include product-specific data dynamically

3. Settings Control:

• Writing style: Professional, Creative, Casual, Technical
• Language: 50+ languages supported
• Content length: 150-1000 characters (customizable)
• Temperature: Control creativity vs consistency

4. Edit Before Applying:

• Preview all generated content
• Edit inline before applying to products
• Regenerate if quality doesn't meet standards
• Approve/reject workflow (Advanced mode)

5. Post-Generation Editing:

• All content can be manually edited after applying
• Use as starting point and refine manually
• Blend AI efficiency with human expertise

Related: Settings Configuration, Custom Variables

Does the plugin support multiple languages?

Yes, 50+ languages supported by all AI providers (OpenAI, Gemini, OpenRouter).

Supported languages include:

• European: English, Spanish, French, German, Italian, Portuguese, Dutch, Polish, Russian, Swedish, Norwegian, Danish, Finnish
• Asian: Japanese, Chinese (Simplified & Traditional), Korean, Thai, Vietnamese, Indonesian, Hindi, Bengali
• Middle Eastern: Arabic, Hebrew, Turkish, Persian
• Others: 30+ additional languages

How to use:

1. Navigate to Settings → Content Settings
2. Select your target language from dropdown
3. Save settings
4. Generate content - all output will be in selected language

Per-generation override:

• Change language for specific bulk operations
• Different languages for different product categories
• Test multiple languages before committing

Quality by language:

• Best quality: English (most training data)
• Excellent: Spanish, French, German, Japanese, Chinese
• Good: Most other major languages
• Variable: Less common languages (test before bulk use)

Multilingual stores:

• Use WPML or Polylang for multi-language product management
• Generate content separately for each language
• Maintain consistent brand voice across languages

Related: AI Models Guide discusses language capabilities by model.

Can I generate content for variable products?

Yes, full support for all WooCommerce product types:

Variable product handling:

Parent product description:

• Generated based on common attributes across variations
• Highlights available options (sizes, colors, etc.)
• Focuses on product family overview

Variation-specific descriptions:

• Generate unique descriptions per variation
• Highlight variation-specific attributes (size, color, material)
• Differentiate variations clearly

Example workflow (variable product with 5 variations):

1. Generate parent description highlighting product family
2. Use bulk generation to create variation-specific descriptions
3. Include variation attributes in prompts: {pa_size}, {pa_color}
4. Apply to all 5 variations in one operation (1-2 minutes)

Best practices:

• Map variation attributes to custom variables
• Use consistent format across variations
• Highlight unique selling points per variation
• Test with one variation before bulk applying

Related: Custom Variables Guide shows attribute mapping.

What content types can be generated?

Four primary content types:

1. Product Descriptions (Full):

• Length: 300-800 characters (customizable)
• Purpose: Detailed product information, features, benefits
• Use case: Main product description field
• Credit cost: 1 credit (Advanced mode)
• Example output: "Experience premium sound quality with these wireless Bluetooth headphones. Featuring advanced noise cancellation technology..."

2. Short Descriptions:

• Length: 150-250 characters (customizable)
• Purpose: Brief product summary, key selling point
• Use case: Product archive pages, cart pages
• Credit cost: 1 credit (Advanced mode)
• Example output: "Premium wireless headphones with 30-hour battery and active noise cancellation. Perfect for music lovers on the go."

3. Product Titles:

• Length: 50-60 characters (optimal for SEO)
• Purpose: SEO-optimized product names
• Use case: Product page titles, search results
• Credit cost: 1 credit per title
• Example output: "Premium Wireless Bluetooth Headphones - 30Hr Battery - Black"

4. Product Tags:

• Count: 5-10 tags typically
• Purpose: SEO keywords, product categorization
• Use case: Product taxonomy, search optimization
• Credit cost: 1 credit per product
• Example output: ["wireless headphones", "bluetooth audio", "noise cancelling", "long battery", "premium sound"]

Generation combinations:

Related: Single Product Generation shows all content types.

Can I use custom fields and variables?

Yes, extensive custom field support:

Built-in Variables (Available in both Standard and Advanced modes):

• `{title}` - Product name
• `{category}` - Primary category
• `{price}` - Current price
• `{regular_price}` - Regular price
• `{sale_price}` - Sale price (if on sale)
• `{sku}` - Product SKU
• `{attributes}` - All product attributes
• `{short_description}` - Existing short description

Custom Field Integration (Advanced mode only):

WooCommerce Custom Fields:

• Product attributes: `{pa_brand}`, `{pa_color}`, `{pa_size}`
• Custom meta fields: `{_custom_field_key}`
• Product taxonomies and tags

Advanced Custom Fields (ACF):

• Text fields: `{warranty_years}`, `{model_number}`
• Select fields: `{connectivity_type}`, `{power_source}`
• Textarea fields: `{technical_specs}`, `{special_features}`

Third-Party Plugin Fields:

• Compatible with most plugin custom fields
• Auto-discovery of available fields
• Manual field key entry for advanced use

How to set up:

1. Navigate to Settings → Advanced Bulk Generator → Custom Variables
2. Click "Add Custom Variable"
3. Select field from dropdown (or enter key manually)
4. Name your variable (e.g., "brand" → `{brand}`)
5. Use in prompts: "Write description for {title} by {brand}"

Example with custom variables:

Without variables (generic): "High-quality video doorbell with smart features."

With variables (specific): "Experience premium home security with the Ring Video Doorbell Pro 2 featuring 2K HDR video, Wi-Fi 5GHz + Bluetooth connectivity, and 2-year warranty."

Related: Custom Variables Guide has 12-minute setup tutorial.

Can I schedule automatic content generation?

Yes, automation jobs available in Pro plan.

Automation Job Features:

Scheduling Options:

• Hourly: Every hour (for frequently updated catalogs)
• Daily: Once per day at specified time
• Weekly: Once per week on chosen day/time
• Custom: Via WP-Cron custom intervals

Product Filtering:

• Categories: Select specific product categories
• Tags: Filter by product tags
• Stock status: In stock, out of stock, on backorder
• Price range: Minimum and maximum price filters
• Custom filters: Meta queries and advanced filtering

Content Types:

• Description generation
• Title optimization
• FAQ generation
• Tag creation

Draft Review Workflow:

• Generate content automatically
• Store in draft queue for review
• Approve/reject before applying to live products
• Bulk approve trusted results

Progress Tracking:

• Real-time progress monitoring
• Success/failure statistics
• Error logs and debugging
• Job execution history

Example automation job:

Scenario: Fashion store with new inventory arriving daily

Configuration:

• Name: "Daily New Product Content"
• Schedule: Daily at 2:00 AM
• Filters: Category = "New Arrivals", Stock Status = "In Stock"
• Action: Generate full description + tags
• Review: Send to draft queue for morning review

Result: 20-50 new products processed automatically each night, ready for approval each morning (2-3 minutes review time).

Related: Automation Jobs Guide has complete setup tutorial.

Pricing & Credits

How does the credit system work?

Credit system applies only to Advanced Bulk Generator.

Free Plan:

• 250 credits/month included
• Resets monthly on signup anniversary date
• Sufficient for ~250 products with full descriptions
• No credit card required

Pro Plan:

• 5,000 credits/month included
• 10x more credits than Free plan
• Sufficient for ~5,000 products with full descriptions
• Priority support included

Credit Costs by Action:

Important notes:

• Standard Bulk Generator: Unlimited, no credits required
• Single Product Generation: No credits consumed (via metabox)
• API costs: Separate from credits, paid to AI provider directly
• Automation jobs: Use credits for each generated product

Credit tracking:

• View balance in Toolkit Dashboard
• Real-time credit display before generation
• Usage summary in Settings → Credit System
• Monthly reset notification

What happens when credits run out:

• Switch to Standard Bulk Generator (unlimited)
• Continue single product generation (no credits)
• Wait for monthly reset
• Upgrade to Pro for more credits

Related: Pricing Plans Guide compares Free vs Pro.

When do credits reset?

Credits reset monthly on your signup anniversary date.

How it works:

1. Signup date determines reset:

   • Signed up on January 15th → Resets on 15th of each month
   • Signed up on March 3rd → Resets on 3rd of each month
   • Signed up on December 31st → Resets on last day of each month

2. Reset timing:

   • Occurs at midnight UTC on reset date
   • All unused credits expire (no rollover)
   • Fresh allocation provided immediately

3. Check your reset date:

   • Navigate to Settings → Credit System
   • View "Next Reset" date in dashboard
   • Receive notification 3 days before reset

Example timeline:

January 15: Signup (250 credits received)
January 15-February 14: Use 180 credits (70 remaining)
February 15: Reset (70 credits expire, 250 new credits received)
February 15-March 14: Use 250 credits (0 remaining)
March 15: Reset (250 new credits received)

Maximizing credits:

✅ Good strategies:

• Plan bulk operations before reset date
• Use all credits before expiration
• Schedule automation jobs to distribute usage evenly

❌ Wasteful strategies:

• Letting credits expire unused
• Bulk generation right after reset (use throughout month)

Pro tip: Set a monthly reminder 3-5 days before reset to use remaining credits.

Related: Pricing Plans Guide explains credit allocation.

Are API costs included in the plugin price?

No, API costs are separate and paid directly to the AI provider.

Cost breakdown:

Plugin Costs:

• Free Plan: $0/month (250 credits)
• Pro Plan: Varies (5,000 credits + premium features)

API Costs (paid to provider):

• OpenAI: $0.002-0.005 per 1K tokens (~$0.002-0.01 per product description)
• Google Gemini: Free tier (1500 requests/day) + paid tiers
• OpenRouter: Free models available + paid premium models

Total cost examples:

Small store (100 products/month):

• Plugin: Free ($0)
• API: ~$1-5/month (OpenRouter free or Gemini free tier)
• Total: $0-5/month

Medium store (500 products/month):

• Plugin: Free or Pro
• API: ~$10-25/month (OpenAI GPT-4o-mini)
• Total: $10-25/month (+ Pro plan if needed)

Large store (2000+ products/month):

• Plugin: Pro plan
• API: ~$40-100/month (OpenAI or Gemini paid)
• Total: $40-100/month (+ Pro plan cost)

Cost optimization tips:

1. Use free tier AI models (OpenRouter, Gemini Flash)
2. Mix Standard and Advanced modes (Standard is unlimited)
3. Choose cost-effective models (GPT-4o-mini vs GPT-4o)
4. Monitor API usage in provider dashboard
5. Set spending limits to avoid overages

Where costs are paid:

• Plugin: Freemius platform (if using Pro)
• API: OpenAI/Google/OpenRouter billing portal

Related: API Provider Setup has cost comparison by provider.

Content & Quality

How can I improve content quality?

10 proven strategies for better AI-generated content:

1. Provide Better Product Data:

• Add detailed product attributes (brand, model, specs)
• Include accurate categories and subcategories
• Fill in short descriptions with key selling points
• Add custom fields for specific features

Before (poor data):

• Title: "Headphones"
• Category: Electronics
• Attributes: None

After (rich data):

• Title: "Sony WH-1000XM4 Wireless Noise Cancelling Headphones"
• Category: Electronics → Audio → Headphones
• Attributes: Brand (Sony), Color (Black), Connectivity (Bluetooth 5.0), Battery (30 hours)

Generated quality improvement: Generic → Specific, detailed, compelling

2. Customize Prompt Templates:

Generic prompt: "Write a product description."

Optimized prompt: "Write a professional product description for {title} targeting audio enthusiasts. Highlight technical specifications, sound quality features, and comfort for extended use. Include brand reputation and warranty information. Style: Technical yet accessible. Length: 400-500 characters."

3. Use Custom Variables:

Map product-specific data to variables:

• `{brand}` → Include brand prominently
• `{warranty_years}` → Emphasize warranty coverage
• `{pa_resolution}` → Highlight technical specs
• `{connectivity}` → Specify connection types

4. Choose Appropriate AI Models:

5. Set Appropriate Writing Style:

Match style to product category:

• Electronics: Technical
• Fashion: Creative
• B2B Equipment: Professional
• Consumer Goods: Casual
• Luxury Items: Persuasive

6. Adjust Content Length:

Optimal lengths by platform:

• Amazon: 500-1000 characters
• Google Shopping: 500-800 characters
• Your website: 300-600 characters
• Social media: 150-300 characters

7. Review and Edit Generated Content:

Always review before applying:

• Check factual accuracy
• Verify brand voice consistency
• Edit for clarity and flow
• Add human touches and personality
• Fix any AI hallucinations

8. Use Advanced Mode for Complex Products:

Advanced mode better handles:

• Products with extensive custom fields
• Technical specifications
• Brand-specific terminology
• Variable products with multiple options

9. Provide Context in System Prompt:

Include in system prompt:

• Target audience description
• Brand voice guidelines
• Industry terminology to use/avoid
• Tone and style preferences
• Regulatory compliance requirements

10. Iterate and Refine:

• Test with small batches (5-10 products)
• Analyze results and identify patterns
• Refine prompts based on feedback
• Re-generate if quality doesn't meet standards
• Build prompt templates for different product types

Example quality improvement workflow:

Iteration 1 (Default settings):

• Quality: 6/10
• Issues: Generic, lacks specific details
• Time: 5 minutes for 10 products

Iteration 2 (Added custom variables):

• Quality: 8/10
• Issues: Better details, still missing brand voice
• Time: 10 minutes for 10 products (5 min setup + 5 min generation)

Iteration 3 (Custom prompt + variables + appropriate model):

• Quality: 9/10
• Issues: Excellent quality, minor manual edits needed
• Time: 15 minutes for 10 products (10 min refinement + 5 min generation)

ROI: 15 minutes upfront investment → Consistent 9/10 quality for all future generations.

Related: Best Practices Guide, Settings Configuration

Will the content be unique for each product?

Yes, each product receives unique content based on its specific data.

How uniqueness is achieved:

1. Product-Specific Data:

• Every product has unique title, price, category, attributes
• AI generates content based on this specific data
• No two products will have identical descriptions (unless data is identical)

2. Dynamic Variables:

• Variables pull unique values per product: `{title}`, `{brand}`, `{pa_color}`
• Custom fields provide product-specific details
• Attributes differentiate variations

3. AI Generation Process:

• Each API call generates fresh content
• Non-deterministic generation creates variations
• Temperature setting controls creativity vs consistency

Uniqueness levels:

High uniqueness (different product types):

• Wireless headphones vs hiking backpack
• Completely different content, features, benefits
• 100% unique descriptions

Medium uniqueness (similar products, different attributes):

• Black headphones vs white headphones
• Shared base features, different specific details
• 70-90% unique content

Low uniqueness (identical products, minimal differentiation):

• Simple product vs simple product with same title/category
• May have similar phrasing, different sentence structure
• 50-70% unique content

Improving uniqueness:

For similar products:

1. Add distinguishing custom fields (model number, features, year)
2. Use product-specific attributes (color, size, material)
3. Include variation-specific details in prompts
4. Manually edit to add unique selling points

For product variations:

1. Map variation attributes to variables
2. Highlight variation-specific features
3. Use different prompts per variation type
4. Edit parent vs variation descriptions differently

Example - Similar products with high uniqueness:

Product 1: Black Wireless Headphones Generated: "Experience superior audio with these sleek black wireless headphones. The midnight finish complements any style while delivering crystal-clear sound..."

Product 2: White Wireless Headphones Generated: "Elevate your listening experience with these elegant white wireless headphones. The pristine pearl finish adds sophistication while providing exceptional audio quality..."

Same features, completely unique descriptions.

Plagiarism concerns:

• AI-generated content is original (not copied from existing sources)
• Each generation creates new unique text
• Safe for SEO (Google treats as original content)
• Can use plagiarism checkers to verify uniqueness

Related: Custom Variables Guide maximizes content uniqueness.

Can I maintain my brand voice?

Yes, extensive brand voice customization available.

5 methods to ensure brand voice consistency:

1. Customize System Prompt:

Generic system prompt: "You are a product description writer."

Brand-specific system prompt: "You are Patagonia's product copywriter. Write descriptions emphasizing environmental sustainability, product durability, and outdoor adventure. Use an authentic, down-to-earth tone that reflects our commitment to environmental activism and quality craftsmanship. Avoid marketing hype; focus on honest product benefits and responsible manufacturing."

2. Define Writing Style:

Choose or customize style:

• Professional: Trustworthy, authoritative, business-focused
• Creative: Engaging, emotive, marketing-focused
• Casual: Friendly, conversational, approachable
• Technical: Specification-heavy, feature-focused, precise
• Persuasive: Sales-oriented, benefit-focused, call-to-action driven

3. Include Brand Guidelines in Prompts:

Example brand guidelines to include:

Brand Voice: [Your Brand]
- Tone: Warm, knowledgeable, customer-focused
- Language: Simple, jargon-free, accessible
- Values: Sustainability, quality, innovation
- Avoid: Superlatives, hype, aggressive sales language
- Include: Product benefits, use cases, sustainability info
- Always mention: [Brand differentiators]

4. Use Consistent Variables and Terminology:

Map brand-specific terms to variables:

• {sustainability_rating} for eco-conscious brands
• {craftsmanship_details} for artisan brands
• {innovation_features} for tech brands
• {heritage_story} for legacy brands

5. Review and Refine Generated Content:

Establish quality gates:

• First generation → Review 10 samples
• Refine prompts based on voice consistency
• Regenerate with improved prompts
• Manual edits for brand voice fine-tuning
• Build template library for different product types

Example brand voice comparison:

Luxury fashion brand: "Indulge in timeless elegance with this exquisitely crafted silk scarf. Hand-woven by master artisans using centuries-old techniques, each piece embodies sophistication and refined taste. The lustrous fabric drapes beautifully, elevating any ensemble with understated luxury."

Budget-friendly fashion brand: "Look amazing without breaking the bank! This stylish silk scarf adds instant flair to any outfit. Super soft fabric, trendy patterns, and unbeatable value make it a must-have accessory. Perfect for everyday wear or special occasions!"

Same product (silk scarf), completely different brand voices achieved through prompt customization.

Testing brand voice:

1. Generate 5-10 sample descriptions
2. Compare to existing brand content
3. Score consistency (1-10 scale)
4. Identify voice mismatches
5. Refine prompts and regenerate
6. Repeat until 8-10/10 consistency achieved

Related: Settings Configuration shows prompt customization, Best Practices has brand voice strategies.

Technical & Compatibility

Is my data secure?

Yes, comprehensive security measures protect your data:

Data Security Practices:

1. API Key Encryption:

• All API keys stored encrypted in WordPress database
• Uses OpenSSL AES-256-CBC encryption
• Keys never transmitted in plain text
• Automatic migration from legacy storage

2. Data Transmission:

• All API calls use HTTPS encryption
• Product data sent only during active generation
• No persistent storage on third-party servers
• Direct WordPress → AI provider communication

3. No Data Collection by Plugin:

• Plugin does not store generated content on external servers
• No telemetry or usage tracking to external services
• All data remains in your WordPress installation
• Optional local logging for debugging only

4. AI Provider Data Handling:

OpenAI:

• Data sent to OpenAI API for generation
• Subject to OpenAI's privacy policy
• Can opt out of training data usage
• Data retention: 30 days then deleted

Google Gemini:

• Data sent to Google AI API
• Subject to Google Cloud privacy policy
• Enterprise privacy controls available
• Data retention: As per Google Cloud terms

OpenRouter:

• Aggregates multiple AI providers
• Data handling varies by selected model
• Check specific provider policies

5. WordPress Security Best Practices:

✅ Security recommendations:

• Keep WordPress, WooCommerce, and plugin updated
• Use strong admin passwords
• Limit user capabilities appropriately
• Enable WordPress security plugins
• Use SSL certificate for your site
• Regular database backups

6. Compliance:

• GDPR compliant (data minimization, user control)
• No PII collected by plugin
• Product data processing transparent
• User consent via AI provider ToS

7. What data is sent to AI providers:

Sent during generation:

• Product title
• Product description (if using append mode)
• Categories and tags
• Attributes and custom fields (if mapped to variables)
• Custom prompt text

Never sent:

• Customer data
• Order information
• Payment details
• Admin credentials
• Unrelated product data

Security checklist:

• API keys encrypted ✅
• HTTPS encryption ✅
• No external data storage ✅
• WordPress security standards ✅
• Compliance with privacy laws ✅
• Transparent data usage ✅

Related: Installation Guide includes security setup recommendations.

Does the plugin slow down my website?

No, the plugin does not affect frontend performance or loading speed.

Performance characteristics:

Frontend (Public-Facing Site):

• Zero impact: Plugin only loads in WordPress admin area
• No JavaScript or CSS loaded on frontend
• No database queries on product pages
• No API calls during customer browsing
• Website speed remains unchanged

Backend (WordPress Admin):

• Minimal impact: Plugin assets load only on plugin pages
• React components loaded on-demand
• Optimized webpack bundles with code splitting
• No slowdown on other admin pages

Performance impact by operation:

Server resource usage:

During generation:

• Memory: 64-128MB per request
• CPU: <10% during API calls (mostly network wait)
• Database: Minimal writes (history, logs)

At rest:

• Memory: 0MB (no background processes)
• CPU: 0% (dormant when not in use)
• Database: Minimal storage (<5MB typical)

Optimization for large stores:

For 500+ product catalogs:

• Use batch processing (25-50 products at a time)
• Schedule automation during low-traffic periods
• Increase PHP memory limit to 256MB
• Set max execution time to 300 seconds

For shared hosting:

• Use Standard Bulk Generator (faster, less resource intensive)
• Smaller batch sizes (10-25 products)
• Avoid peak traffic times for bulk operations

Measuring actual impact:

Before plugin:

• Test site speed: GTmetrix, Google PageSpeed Insights
• Document load times, performance scores

After plugin:

• Re-test with same tools
• Compare results: Should be identical
• Frontend performance unaffected

Related: Troubleshooting Guide has performance optimization tips.

Can I use this on multiple websites?

Yes, licensing depends on your plan:

Free Plan:

• ✅ Use on unlimited websites
• Install from WordPress.org repository on any site
• Each site requires its own configuration
• Each site needs separate AI provider API key
• No license key needed

Pro Plan:

• License terms vary by purchase platform
• Check specific license for site limits
• Typically: 1 site, 3 sites, or unlimited options
• License activation required per site
• Freemius account manages licenses

Multi-site setup considerations:

What's required per site:

1. Plugin installation: Install on each WordPress site
2. API key configuration: Each site needs AI provider API key (can use same key or different keys)
3. Credit allocation: Credits are per-site (not shared across sites)
4. Settings: Configure separately per site
5. License activation: Pro users activate license per site

Sharing AI provider API keys:

✅ You can:

• Use same OpenAI/Gemini/OpenRouter API key across multiple sites
• Billing combines from all sites to your provider account
• Easier to manage one API account

⚠️ Considerations:

• Monitor combined API usage across all sites
• Set spending limits to avoid overages
• Track which site uses most API credits

Multi-site workflows:

Scenario 1: Same products across sites

• Export settings from Site 1
• Import to Site 2, 3, etc.
• Use same prompt templates
• Consistent brand voice across sites

Scenario 2: Different products per site

• Configure each site independently
• Different prompts per niche/audience
• Separate API keys for cost tracking

License management (Pro):

1. Purchase appropriate license (1-site, 3-site, unlimited)
2. Activate on first site via Freemius
3. Add sites up to license limit
4. Manage licenses in Freemius account dashboard

Related: Installation Guide has multi-site setup tips.

Troubleshooting

Why is my API key not working?

Common causes and solutions:

1. Incorrect Key Format:

OpenAI keys must:

• Start with sk-proj- (new format) or sk- (legacy)
• Be 48+ characters long
• Contain no spaces or line breaks
• Be complete (not truncated when copying)

Gemini keys must:

• Start with AIza
• Be 39 characters long
• Contain no spaces

OpenRouter keys must:

• Start with sk-or-v1-
• Be complete key string
• No spaces or formatting

How to fix:

1. Copy key again from provider dashboard
2. Ensure entire key is copied (no truncation)
3. Paste into Settings → API Settings
4. Click "Validate" to test

2. Billing Not Set Up (OpenAI):

Symptoms:

• Key validates but generation fails
• Error: "You exceeded your current quota"
• Status: 429 error code

Solution:

1. Log in to platform.openai.com
2. Navigate to Billing → Payment methods
3. Add credit card
4. Add minimum $5 credit (recommended: $10-20)
5. Wait 5-10 minutes for activation
6. Test again in plugin

3. API Key Permissions:

Gemini specific:

1. Ensure API key has "Generative Language API" enabled
2. Check project has correct permissions
3. Verify API quotas not exceeded

OpenRouter specific:

1. Check account has credits (for paid models)
2. Verify key has generation permissions
3. Ensure selected model is accessible

4. Key Expired or Revoked:

Check key status:

• OpenAI: Platform → API Keys → Check "Last used" date
• Gemini: Console → API Keys → Status column
• OpenRouter: Dashboard → Keys → Active status

Solution:

• Generate new key if expired
• Delete old key for security
• Update in plugin settings

5. Provider Service Outage:

How to check:

• OpenAI: status.openai.com
• Google Cloud: status.cloud.google.com
• OpenRouter: status.openrouter.ai

If outage confirmed:

• Wait for service restoration (typically 10-60 minutes)
• Switch to alternative provider temporarily
• Check status page for updates

Validation troubleshooting workflow:

1. Copy key fresh from provider dashboard
2. Paste into Settings → API Settings
3. Remove any spaces/line breaks
4. Click "Validate API Key"
5. Check response:
   • ✅ Green checkmark: Key valid
   • ❌ Red X: Check error message
6. Review error details:
   • "Invalid format": Check key format above
   • "Authentication failed": Check billing/permissions
   • "Quota exceeded": Add credits or wait for reset
   • "Service unavailable": Check provider status page

Related: API Provider Setup has detailed troubleshooting by provider.

Generation is very slow, what can I do?

Typical generation times:

• Single product: 3-8 seconds
• Bulk (10 products): 1-2 minutes
• Bulk (50 products): 5-10 minutes
• Bulk (500 products): 30-60 minutes

If experiencing slower speeds, try these solutions:

1. Reduce Batch Size:

Problem: Processing 100+ products at once

Solution:

• Standard Bulk: 25-50 products per batch
• Advanced Bulk: 10-25 products per batch
• Split large operations into multiple batches

Why it helps: Smaller batches reduce server memory usage, prevent timeouts, enable faster parallel processing.

2. Check Internet Connection:

Problem: Slow or unstable internet

Solution:

• Test internet speed: fast.com or speedtest.net
• Minimum recommended: 10 Mbps download/upload
• Avoid bulk generation on mobile/cellular connections
• Use wired connection if possible

Why it helps: AI API calls require stable, fast connection for real-time generation.

3. Increase Server Resources:

Problem: PHP memory or execution time limits reached

Solution:

Increase PHP memory limit: Add to wp-config.php:

define('WP_MEMORY_LIMIT', '256M');
define('WP_MAX_MEMORY_LIMIT', '512M');

Increase max execution time: Add to .htaccess (Apache):

php_value max_execution_time 300

Or add to php.ini:

max_execution_time = 300

Why it helps: Bulk operations need adequate memory and time to complete without timeouts.

4. Choose Faster AI Models:

Fastest models by provider:

How to switch:

1. Navigate to Settings → API Settings
2. Select faster model from dropdown
3. Save settings
4. Re-run generation

Trade-off: Faster models may have slightly lower quality than premium models (GPT-4o, Gemini Pro). Test quality before committing to large batches.

5. Optimize Prompt Length:

Problem: Very long custom prompts (>500 words)

Solution:

• Keep prompts concise (200-300 words ideal)
• Remove redundant instructions
• Use variables instead of examples
• Focus on essential guidelines only

Why it helps: Shorter prompts = faster processing and lower API costs.

6. Use Standard Instead of Advanced:

Problem: Advanced mode slower due to credit checks and history storage

Solution:

• Switch to Standard Bulk Generator for speed
• No credit system = faster processing
• Simpler workflow = less overhead
• Still excellent quality for most products

When to use Standard:

• Large catalogs (500+ products)
• Speed more important than custom variables
• Simple products without extensive custom fields

7. Schedule During Off-Peak Hours:

Problem: Server/API slower during peak traffic

Solution:

• Run bulk operations at night (12 AM - 6 AM)
• Use automation jobs (Pro) to schedule automatically
• Avoid weekday business hours
• Check provider status pages for known slow periods

Why it helps: Less server load, less API congestion, faster response times.

8. Monitor and Diagnose:

Use browser developer tools:

1. Open Developer Tools (F12)
2. Go to Network tab
3. Run generation
4. Check API request times:
   • <3 seconds: Normal
   • 3-8 seconds: Acceptable
   • >8 seconds: Investigate

Check PHP error logs:

• Enable WP_DEBUG in wp-config.php
• Check /wp-content/debug.log for errors
• Look for timeout or memory errors

Related: Troubleshooting Guide has comprehensive performance optimization.

Generated content is not saving to products

Common causes and solutions:

1. Insufficient User Permissions:

Problem: WordPress user lacks permission to edit products

Solution:

1. Check user role: Navigate to Users → All Users
2. Verify role is Administrator or Shop Manager
3. Required capabilities:
   • edit_products - For single product editing
   • manage_woocommerce - For bulk operations
   • manage_options - For settings access

How to fix:

• Log in as Administrator
• Or ask site admin to grant correct role
• Test generation again

2. Product Locked by Another User:

Problem: Product being edited by another user simultaneously

Solution:

1. Check if product shows "locked" icon in product list
2. Wait for other user to finish editing
3. Or force unlock: Hover over product → Click "Take over"
4. Apply generated content again

Prevent future locks:

• Coordinate bulk operations with team
• Use separate user accounts per team member
• Avoid simultaneous editing of same products

3. Plugin Conflict:

Problem: Other plugin interfering with content saving

Common culprits:

• Other content generation plugins
• Custom product field plugins
• Security plugins blocking updates
• Caching plugins preventing saves

Diagnostic steps:

1. Deactivate all other plugins except WooCommerce + AI Product Tools
2. Test generation and save
3. If works: Reactivate plugins one by one
4. Identify conflicting plugin
5. Contact plugin support or find alternative

4. Database Connection Issues:

Problem: WordPress database not accessible or overloaded

Solution:

1. Check WordPress database connection:
   • Can you edit products manually?
   • Do other WordPress operations work?
2. Contact hosting support if database issues suspected
3. Check for database errors in PHP error log
4. Repair database: WP-CLI → wp db repair or phpMyAdmin → Check/Repair tables

5. JavaScript Errors:

Problem: JS errors preventing save functionality

Solution:

1. Open browser Developer Tools (F12)
2. Go to Console tab
3. Look for errors (red text)
4. Common fixes:
   • Clear browser cache (Ctrl+Shift+Delete)
   • Disable browser extensions temporarily
   • Try different browser
   • Update plugin to latest version

6. Server Timeout:

Problem: Save operation timing out before completion

Solution:

• Increase max execution time (see "Generation is slow" above)
• Save fewer products at once
• Contact hosting for server performance review

Troubleshooting workflow:

1. Test manual save: Edit product manually, save. Works? → Not permission issue.
2. Check console: F12 → Console tab. JS errors? → Fix or report.
3. Test plugin conflict: Deactivate others. Works? → Identify conflict.
4. Review user role: Administrator? Shop Manager? → Check permissions.
5. Check database: Other WP operations work? → Database connection OK.
6. Contact support: Provide error logs, steps to reproduce, system info.

Related: Troubleshooting Guide, Plugin Conflicts

What You've Learned

Congratulations! You now know:

• ✅ How to quickly find answers to specific questions using the FAQ
• ✅ System requirements, setup process, and API key configuration
• ✅ Differences between Standard and Advanced Bulk Generator modes
• ✅ How the credit system works and when credits reset
• ✅ Strategies for improving content quality and maintaining brand voice
• ✅ Solutions to common technical issues (API keys, performance, saving content)

Next Steps

Immediate Actions:

• Start your first generation - 5-minute tutorial
• Explore bulk generation - Scale to 10-500 products
• Configure settings - Optimize prompts and quality

Advanced Topics:

• Master custom variables - Dynamic content with product data
• Review best practices - Optimization strategies
• Set up automation - Scheduled generation

Related Topics

• Troubleshooting Guide - Detailed solutions for technical issues
• Best Practices - Optimization tips and advanced techniques
• Installation Guide - Complete setup and configuration
• Quick Start - Get started in 5 minutes
• API Provider Setup - Detailed API key configuration