Enhanced Metabox Guide

Time to complete: 2-3 minutes per product You'll learn: How to generate product content directly from the WooCommerce product editor without switching interfaces

The Enhanced Metabox brings AI-powered content generation directly to your WooCommerce product edit screen. Generate titles, descriptions, and tags for individual products without leaving the editor, making it perfect for single-product optimization and quick content updates.

---

---

Quick Start: Use the Metabox

Step 1: Access the Metabox

1. Navigate to Products → All Products in WordPress admin

2. Click Edit on any product (or Add New to create one)

3. Scroll down to find the AI Product Tools metabox:

   • Usually appears in the right sidebar
   • Below product data tabs
   • Labeled "AI Product Tools"

Step 2: Generate Product Description

1. Click Generate Description button in metabox

2. Wait 3-10 seconds while AI analyzes:

   • Product title
   • Categories and tags
   • Attributes (size, color, material)
   • Existing content (if any)

3. Review generated content in preview area:

   • Full description or short description
   • Character count indicator
   • Quality check before applying

Step 3: Generate Product Title

1. Click Generate Title button in metabox

2. AI creates SEO-optimized title suggestion:

   • 50-60 characters optimal for Google
   • Keywords placed naturally
   • Brand name included if available

3. Review title in preview:

   • Character count (aim for 50-60)
   • Keyword placement
   • Brand voice consistency

4. Apply title:

   • Click Apply Title to replace current title
   • Or click Regenerate for alternative version

Step 4: Generate Product Tags

1. Click Generate Tags button in metabox

2. Review suggested tags:

   • Category-based tags
   • Attribute tags (color, size, material)
   • Feature tags (benefits, use cases)
   • Typical suggestion: 5-10 relevant tags

3. Select tags to apply:

   • Check individual tags
   • Or click Apply All for bulk application
   • Merge with existing tags automatically

4. Click Apply Selected Tags

Step 5: Save Product

1. Review all generated content:

   • Description in product data tabs
   • Title in title field
   • Tags in tags section

2. Click Update button to save product

3. Visit product page on storefront to verify:

   • Title appears correctly
   • Description displays properly
   • Tags visible in product details

---

Complete End-to-End Example

Let's generate content for a new wireless headphones product using the Enhanced Metabox.

Product Details:

• Name: (not yet defined - will use metabox)
• Category: Electronics → Audio → Headphones
• Attributes: Color: Black, Connectivity: Bluetooth 5.0, Battery: 30 hours
• Price: $79.99
• Goal: Generate complete content without leaving product editor

Workflow (3 minutes)

Step 1: Create Product and Add Basic Info (1 minute)

1. Navigate to Products → Add New
2. Add temporary title: "Wireless Headphones"
3. Set price: $79.99
4. Select category: Electronics → Audio → Headphones
5. Add attributes:
   • Color: Black
   • Connectivity: Bluetooth 5.0
   • Battery Life: 30 hours
6. Scroll down to AI Product Tools metabox

Step 2: Generate Optimized Title (30 seconds)

1. Click Generate Title in metabox
2. Wait 5-8 seconds for AI processing
3. Preview generated title:

   Premium Wireless Bluetooth Headphones - 30Hr Battery Life - Black

4. Character count: 58 (optimal for Google)
5. Click Apply Title
6. Title replaces "Wireless Headphones" at top of page

Step 3: Generate Description (45 seconds)

1. Click Generate Description in metabox
2. Wait 5-8 seconds for generation
3. Preview content:

   Experience premium sound quality with our Wireless Bluetooth Headphones.
   Featuring advanced Bluetooth 5.0 technology for seamless connectivity and
   crystal-clear audio. The long-lasting 30-hour battery ensures all-day
   listening without interruption. Sleek black design combines style with
   comfort for extended wear. Perfect for music lovers, commuters, and audio
   enthusiasts seeking professional-grade sound on the go.

4. Click Apply Description
5. Content fills the product description field

Step 4: Generate Tags (30 seconds)

1. Click Generate Tags in metabox
2. AI suggests 7 tags:
   • wireless headphones
   • bluetooth audio
   • long battery
   • premium sound
   • black headphones
   • noise cancelling
   • portable audio
3. Click Select All
4. Click Apply Selected Tags
5. Tags added to product

Step 5: Save and Verify (15 seconds)

1. Scroll to top of product editor
2. Click Publish button
3. Click View Product to see live page
4. Verify:
   • ✅ Title: SEO-optimized with keywords
   • ✅ Description: Complete and compelling
   • ✅ Tags: Relevant and searchable

Total time: 3 minutes ✅ Credits used: ~4-6 credits (title + description + tags)

Result: Complete product content generated without leaving the editor. Ready for customers!

---

Metabox Features

Generation Options

Content Types Available:

Generation Controls:

• Model Selection: Choose AI model (GPT-4o-mini, Gemini Flash, etc.)
• Language: Generate in 50+ languages
• Style: Professional, creative, casual, technical
• Preview First: Review before applying changes

Credit System Integration

How Credits Work:

The Enhanced Metabox uses Advanced Bulk Generator credits:

• Free Plan: 250 credits/month
• Pro Plan: 2,500 credits/month
• Credit Reset: Monthly on signup date

Credit Display:

Metabox shows remaining credits in real-time:

• Green: Plenty of credits (>100)
• Yellow: Running low (<50)
• Red: Nearly exhausted (<10)

Optimization Tips:

• Generate only for products that need improvement
• Use bulk generation for large batches (more efficient)
• Test with single products first before scaling

Real-Time Preview

Preview Features:

Before applying any generated content, you can:

1. Review Content Quality:

   • Read generated text
   • Check for accuracy
   • Verify brand voice

2. Check Metrics:

   • Character count (titles: 50-60 optimal)
   • SEO score (keyword density)
   • Readability level

3. Compare Options:

   • Regenerate for alternatives
   • Compare multiple versions
   • Choose best fit

4. Edit Inline:

   • Click preview to edit
   • Make minor adjustments
   • Apply custom version

---

Advanced Features

Smart Data Integration

Automatic Context Analysis:

The metabox automatically uses:

• Product Title: Current or temporary title
• Categories: Primary and secondary categories
• Attributes: All product attributes (color, size, material, etc.)
• Price: Current pricing tier
• Stock Status: Availability information
• Existing Content: Previous descriptions or notes
• Custom Fields: Advanced Custom Fields (ACF) integration

Result: AI-generated content perfectly tailored to your specific product.

Keyboard Shortcuts

Quick Actions:

• Ctrl/Cmd + G - Generate description
• Ctrl/Cmd + T - Generate title
• Ctrl/Cmd + K - Generate tags
• Ctrl/Cmd + Enter - Apply and save product

---

Troubleshooting

Issue: Metabox not visible in product editor

Symptoms:

• Can't find AI Product Tools metabox anywhere
• Sidebar appears empty or missing sections
• Metabox was visible before but disappeared
• Only see default WooCommerce metaboxes

Cause: Screen Options has metabox disabled or plugin conflict

Solution:

1. Enable via Screen Options:

   • Click Screen Options tab at top-right of product editor
   • Find "AI Product Tools" checkbox in the list
   • Check the box to enable metabox
   • Scroll down sidebar to find metabox

2. Verify plugin is active:

   • Navigate to Plugins → Installed Plugins
   • Find "AI Product Tools"
   • Ensure status shows "Active" (not "Inactive")
   • If inactive, click Activate

3. Check user permissions:

   • Verify you have edit_products capability
   • Log in as Administrator to test
   • If metabox appears as admin, it's a permissions issue
   • Contact site admin to grant proper permissions

4. Test for plugin conflicts:

   • Deactivate all plugins except AI Product Tools and WooCommerce
   • Refresh product editor
   • If metabox appears, a plugin conflict exists
   • Reactivate plugins one by one to identify culprit

5. Clear browser cache:

   • Press Ctrl+Shift+Delete (Windows) or Cmd+Shift+Delete (Mac)
   • Select "Cached images and files"
   • Clear cache
   • Force refresh product editor (Ctrl+Shift+R)

Related: Plugin Conflicts

Issue: Generation fails with error message

Symptoms:

• Click Generate button but nothing happens
• Error message appears: "Generation failed"
• Loading spinner appears but times out
• "API connection error" or "Invalid API key" message

Cause: API key invalid, credits exhausted, or provider issue

Solution:

1. Verify API key is valid:

   • Navigate to AI Product Tools → Settings → API Settings
   • Check API key field shows green ✅ checkmark
   • If red ❌ appears, API key is invalid
   • Re-enter API key from provider dashboard
   • Click Validate button to test connection

2. Check credit balance:

   • Look at metabox credit display
   • If shows "0 credits remaining", you're out of credits
   • Wait for monthly reset (date shown in Settings)
   • Or upgrade to Pro for more credits
   • Use Standard Bulk Generator (unlimited, no credits) instead

3. Test API provider connection:

   • Navigate to Settings → API Settings
   • Try different AI model from dropdown
   • Some models may be temporarily unavailable
   • Switch to alternative provider (OpenRouter → OpenAI)

4. Check product data completeness:

   • Ensure product has a title (even temporary)
   • Add at least one category
   • Include some attributes or description
   • AI needs minimum data to generate content

5. Check browser console for errors:

   • Press F12 to open developer tools
   • Go to Console tab
   • Look for errors mentioning "aipt" or "api"
   • Screenshot errors and contact support if needed

Related: API Provider Setup, Troubleshooting Guide

Issue: Generated content low quality or generic

Symptoms:

• Descriptions are vague and don't match product
• Missing important product details (brand, model, specs)
• Generic phrases like "high quality product"
• Tags are irrelevant or too broad
• Title doesn't include key features

Cause: Insufficient product data for AI to analyze

Solution:

1. Add complete product information before generating:

   • Title: Include brand, model, and key feature
     • Before: "Headphones"
     • After: "Sony WH-1000XM4 Wireless Noise Cancelling Headphones"
   • Categories: Add all relevant categories and subcategories
   • Attributes: Fill in all attributes (brand, color, size, material, model)
   • Short Description: Add key selling points or specs
   • Custom Fields: Populate Advanced Custom Fields if using them

2. Improve product data quality:

   • Add specific, detailed attribute values
   • Use standardized terminology (not abbreviations)
   • Include brand names in attributes
   • Add model numbers where applicable

3. Customize generation prompts:

   • Navigate to AI Product Tools → Settings
   • Update System Prompt to emphasize your priorities:

     Generate detailed product descriptions that include:
     - Brand name and model number prominently
     - Specific technical specifications
     - Key features and benefits
     - Use cases and target audience
     Maximum {max_length} characters.

   • Save settings and regenerate content

4. Use different AI model:

   • In metabox, try switching AI model
   • Premium models (GPT-4o) often produce better quality
   • Test with 2-3 models to find best fit
   • Gemini Pro good for detailed, technical content

5. Edit generated content:

   • Use AI output as starting point
   • Click preview area to edit inline
   • Add missing details manually
   • Apply customized version

Related: Settings Configuration, Best Practices

---

When to Use Enhanced Metabox

Ideal Use Cases:

---

Best Practices

Generation Workflow

Do's:

• ✅ Add complete product data before generating
• ✅ Preview all content before applying
• ✅ Use different models for different product types
• ✅ Edit generated content when needed
• ✅ Test with one product before bulk operations

Don'ts:

• ❌ Don't generate without product data (poor results)
• ❌ Don't apply without reviewing (may contain errors)
• ❌ Don't use for large batches (use bulk mode instead)
• ❌ Don't ignore credit balance (may run out mid-workflow)

Content Quality

Optimization Tips:

1. For Better Titles:

   • Include brand name in product title first
   • Add key feature or benefit
   • Keep under 60 characters
   • Test multiple variations

2. For Better Descriptions:

   • Fill in all product attributes
   • Add short description with key points
   • Include categories and tags
   • Specify target audience in custom fields

3. For Better Tags:

   • Use specific attributes (not generic)
   • Include category information
   • Add brand and model to attributes
   • Review suggested tags before applying all

---

What You've Learned

Congratulations! You now know how to:

• ✅ Find and access the Enhanced Metabox in product editor
• ✅ Generate titles, descriptions, and tags for single products
• ✅ Preview and review content before applying
• ✅ Use credits efficiently with the metabox
• ✅ Troubleshoot common metabox issues (visibility, errors, quality)
• ✅ Optimize product data for better AI-generated content

---

Next Steps

Immediate Actions:

• Generate bulk content - Scale up to 10-500 products
• Optimize titles at scale - Bulk SEO optimization
• Customize settings - Fine-tune prompts for better quality

Advanced Workflows:

• Set up automation - Auto-generate for new products
• Use custom variables - Map product fields to prompts
• Learn best practices - Master content generation

Related Topics

• Single Product Generation - Detailed single-product guide
• Bulk Generation Guide - Scale to 10-500 products
• Title Generator - SEO-optimized bulk titles
• Settings Configuration - Customize AI behavior
• Troubleshooting Guide - Common issues and solutions