WooBlurb Documentation

AI-Powered Product Descriptions for WooCommerce

Getting Started

Welcome to WooBlurb! Transform your product catalog with AI-generated descriptions powered by Claude.

What is WooBlurb?

WooBlurb is a WordPress plugin that automatically generates high-quality, SEO-optimized product descriptions for your WooCommerce store using advanced AI technology. Save hours of writing time while maintaining consistent, professional product copy across your entire catalog.

Lightning Fast

Generate descriptions for hundreds of products in minutes, not hours.

SEO Optimized

Each description is crafted to improve search engine visibility.

AI-Powered

Powered by Claude, the most advanced AI model available.

Customizable

Control tone, length, and style to match your brand voice.

Installation

1

Download the Plugin

Download WooBlurb from your purchase email or account dashboard at wooblurb.com.

2

Upload to WordPress

In your WordPress admin, go to Plugins → Add New → Upload Plugin. Choose the WooBlurb ZIP file and click "Install Now".

3

Activate the Plugin

After installation completes, click "Activate Plugin" to enable WooBlurb on your site.

4

Enter Your License Key

Navigate to WooBlurb → Settings and enter your license key. You can find this in your purchase confirmation email.

System Requirements

  • WordPress: Version 5.8 or higher
  • WooCommerce: Version 6.0 or higher
  • PHP: Version 7.4 or higher
  • License Key: Active WooBlurb subscription
  • Credits: Purchase credits to generate descriptions

Configuration & Settings

Configure WooBlurb to match your needs by going to WooBlurb → Settings in your WordPress admin.

License Settings

License Key

Your unique license key connects your site to WooBlurb's AI service. Enter the license key you received after purchase.

  • Format: XXXX-XXXX-XXXX-XXXX
  • Find it in your purchase confirmation email
  • One license key per site
  • Can be updated anytime from Settings

AI Model

Powered by Claude

WooBlurb uses Claude, the most advanced AI language model available. This ensures the highest quality descriptions with superior understanding of context, tone, and SEO best practices.

No configuration needed — you're always using the best model automatically.

Target Field

Choose which description field(s) to update:

  • Both (Recommended): Updates both long and short descriptions for complete product coverage
  • Long Description Only: Updates the main product description only
  • Short Description Only: Updates the short excerpt/summary only

Pricing Note: All options cost the same — 1 credit per product regardless of which fields you update.

Tone Settings

Select the tone that matches your brand voice:

Tone Best For Example Style
Professional B2B stores, technical products Formal, authoritative, trustworthy
Casual Lifestyle brands, everyday products Friendly, approachable, conversational
Enthusiastic Fashion, gifts, consumer goods Exciting, energetic, engaging
Luxury Premium products, high-end items Sophisticated, elegant, exclusive

Length Settings

Control how detailed your descriptions should be:

  • Concise: Brief and to-the-point (~50-100 words for long description)
  • Standard: Balanced detail level (~150-250 words for long description)
  • Detailed: Comprehensive and thorough (~300-400 words for long description)

Short descriptions are always brief regardless of this setting.

Custom Instructions

Add specific instructions to customize how descriptions are generated. This optional field allows you to guide the AI with your unique requirements.

Examples:

  • "Always mention free shipping on orders over $50"
  • "Include a call-to-action at the end of each description"
  • "Emphasize eco-friendly and sustainable aspects"
  • "Write for an audience of healthcare professionals"
  • "Include technical specifications in bullet points"

Context Options

Include Product Attributes

When enabled, the AI considers product attributes (like color, size, material) when generating descriptions. This creates more accurate and detailed copy.

Recommended: Enabled for variable products with multiple attributes.

Include Category Context

When enabled, the AI considers the product's category to provide relevant context and industry-appropriate language.

Recommended: Enabled for better category-specific descriptions.

Performance Settings

Concurrent Processes (1-5)

Controls how many products are processed simultaneously during bulk generation.

  • Lower (1-2): Safer for shared hosting, slower processing
  • Medium (3): Balanced speed and stability (recommended)
  • Higher (4-5): Fastest processing, requires robust hosting

Auto-retry Failed Products

Automatically retry failed products after 5 minutes. Enable this to handle temporary API issues or network problems without manual intervention.

Generating Descriptions

Single Product Generation

Generate a description for one product at a time directly from the product edit screen.

1

Edit Your Product

In WordPress admin, go to Products and click on any product to edit it.

2

Find the WooBlurb Panel

Scroll down to the product description area. You'll see a WooBlurb panel with generation controls.

3

Click "Generate Description"

Click the button to generate AI descriptions. The process typically takes 5-15 seconds per product.

4

Review and Save

Review the generated description, make any desired edits, and update the product to save your changes.

Bulk Generation

Generate descriptions for multiple products at once — perfect for large catalogs or new imports.

1

Go to Products List

Navigate to Products → All Products in your WordPress admin.

2

Select Products

Check the boxes next to the products you want to generate descriptions for. You can select as many as you need.

3

Choose Bulk Action

From the "Bulk Actions" dropdown at the top of the products list, select Generate WooBlurb Description and click "Apply".

4

Monitor Progress

Go to WooBlurb → Batches to monitor the progress of your bulk generation job.

Generation Status

Track the status of your product descriptions with these badges:

Status Meaning Action
Processing Currently being generated by AI Wait for completion (usually 5-15 seconds)
Pending Review Generated and ready for your review Review, edit if needed, and publish
Reviewed Approved and published No action needed
Original Not generated by WooBlurb Generate when ready

Review Workflow

WooBlurb includes a review system to ensure quality control:

  1. Generation: AI creates the description based on your settings
  2. Pending Review: Description is saved but marked for review
  3. Your Review: You check the description and make any edits
  4. Approval: Mark as "Reviewed" or let it auto-approve after editing
  5. Published: Description is live on your product page

Credits System

How Credits Work

WooBlurb uses a simple credit system that's easy to understand:

The Rule: 1 credit = 1 product description

It's Always the Same:

  • Long description only? 1 credit
  • Short description only? 1 credit
  • Both descriptions? Still 1 credit
  • Any tone? 1 credit
  • Any length? 1 credit
  • Include attributes? 1 credit
  • Custom instructions? 1 credit

No complicated pricing tiers or hidden fees — just simple, predictable costs.

Checking Your Balance

View your credit balance anytime by going to WooBlurb → Credits.

The Credits dashboard shows:

  • Current Balance: How many credits you have available
  • Total Generations: Lifetime count of descriptions generated
  • Success Rate: How many generations completed successfully
  • Recent Transactions: Your latest credit usage and purchases
  • Last Used: When you last generated a description

Purchasing Credits

1

Go to Credits Page

Navigate to WooBlurb → Credits in your WordPress admin.

2

Click "Purchase More Credits"

This button will take you to the WooBlurb website where you can buy credit packages.

3

Choose Your Package

Select the credit package that best fits your needs. Larger packages offer better value.

4

Complete Purchase

After payment, credits are automatically added to your account within minutes.

Credit Packages

Choose the package that matches your catalog size:

  • Starter: 100 credits — Perfect for small stores
  • Growth: 500 credits — Great for growing catalogs
  • Business: 1,000 credits — Ideal for established stores
  • Enterprise: 5,000+ credits — For large catalogs and agencies

Credits never expire and can be used anytime.

Low Balance Warnings

WooBlurb will notify you when your credit balance is running low:

  • Under 10 credits: Warning message on Credits page
  • 0 credits: Cannot generate new descriptions until credits are purchased

Pro tip: Set a reminder to check your balance monthly if you generate descriptions regularly.

Best Practices

Optimizing AI Output

1. Fill in Product Data First

The AI generates better descriptions when you have complete product information:

  • Product title (clear and descriptive)
  • Product categories
  • Product attributes (size, color, material, etc.)
  • Product tags
  • Product price

The more data the AI has to work with, the more accurate and detailed your descriptions will be.

2. Use Descriptive Product Titles

Instead of: Blue Shirt

Use: Men's Premium Cotton T-Shirt - Navy Blue

Better product titles lead to better AI-generated descriptions.

3. Configure Custom Instructions

Add brand-specific guidelines to maintain consistency:

  • Your unique selling propositions
  • Shipping and return policies
  • Quality guarantees
  • Target audience information
  • Industry-specific terminology

4. Review and Refine

While the AI generates excellent descriptions, always review them to:

  • Ensure accuracy of product details
  • Add any specific brand messaging
  • Incorporate current promotions or offers
  • Match your exact brand voice

SEO Best Practices

Maximize search engine visibility with these tips:

1. Include Target Keywords

Add important keywords to your custom instructions:

  • "Include the keyword 'organic cotton' naturally"
  • "Emphasize 'handmade' and 'artisan'"
  • "Mention 'sustainable' and 'eco-friendly'"

2. Use Proper Product Categories

Categories help the AI understand context and use relevant industry terms that customers search for.

3. Enable Category Context

Turn on "Include Category Context" in settings to get SEO-optimized descriptions tailored to your product categories.

4. Vary Description Length

Longer descriptions (Detailed setting) generally perform better for SEO, but balance with user experience.

Workflow Efficiency

1. Batch Similar Products

Generate descriptions for similar products together with consistent settings for uniformity.

2. Use Concurrent Processing

If you have good hosting, increase concurrent processes to 4-5 for faster bulk generation.

3. Enable Auto-Retry

Turn on auto-retry to handle temporary issues automatically, reducing manual intervention.

4. Schedule Regular Generations

Generate descriptions when you add new products, not all at once. This maintains consistent quality and spreads credit usage.

5. Monitor Batch Progress

Check WooBlurb → Batches during large bulk generations to catch any issues early.

Content Quality

Choose the Right Tone

Product Type Recommended Tone
Professional equipment, B2B products Professional
Everyday consumer goods Casual
Fashion, gifts, impulse buys Enthusiastic
Premium, high-ticket items Luxury

Choose the Right Length

  • Concise: Simple products, mobile-first audiences
  • Standard: Most products, balanced approach
  • Detailed: Complex products, SEO focus, high-value items

Troubleshooting

Common Issues

Problem: "Invalid License Key"

Possible causes:

  • License key entered incorrectly
  • License has expired
  • License is being used on another site

Solutions:

  • Double-check your license key for typos
  • Copy and paste directly from your purchase email
  • Verify your license is active at wooblurb.com
  • Contact support if you need to transfer your license

Problem: "Insufficient Credits"

Cause: Your credit balance is 0

Solution:

  • Go to WooBlurb → Credits
  • Click "Purchase More Credits"
  • Buy a credit package that fits your needs
  • Credits are added automatically within minutes

Problem: Generation Fails or Times Out

Possible causes:

  • Server timeout (especially on shared hosting)
  • Temporary API connectivity issue
  • Too many concurrent processes for your hosting

Solutions:

  • Enable "Auto-retry" in settings to automatically retry failed products
  • Reduce concurrent processes to 1-2 in settings
  • Try again in a few minutes
  • Contact your hosting provider if timeouts persist
  • Check WooBlurb → Debug Logs for detailed error messages

Problem: Generated Descriptions Don't Match Brand Voice

Cause: Settings need refinement

Solutions:

  • Adjust the tone setting (Professional, Casual, Enthusiastic, Luxury)
  • Add specific brand voice guidelines to Custom Instructions
  • Include examples of your preferred style in Custom Instructions
  • Generate a few test descriptions and refine settings before bulk generation

Problem: Descriptions Are Too Short/Long

Cause: Length setting doesn't match expectations

Solutions:

  • Change length setting (Concise, Standard, Detailed)
  • Add specific word count guidance to Custom Instructions
  • Example: "Keep descriptions between 150-200 words"

Problem: Batch Generation Stuck

Possible causes:

  • Server resource limits
  • PHP timeout settings
  • Large batch size

Solutions:

  • Go to WooBlurb → Batches
  • Check batch status and completion percentage
  • Pause the batch if needed
  • Resume processing after reducing concurrent processes
  • Process smaller batches (20-50 products at a time)

Debug Logs

Access detailed error information via WooBlurb → Debug Logs

Logs include:

  • API request/response details
  • Error messages and codes
  • Processing timestamps
  • Product IDs and batch information

When contacting support, include relevant log entries to help diagnose issues faster.

Getting Help

If you're still experiencing issues:

  • Check Documentation: Review this guide and the FAQ section below
  • Visit Support: Go to wooblurb.com/support
  • Contact Us: Email support@wooblurb.com with:
    • Your license key
    • Description of the issue
    • Steps to reproduce
    • Screenshots if applicable
    • Relevant debug log entries

Our support team typically responds within 24 hours on business days.

Frequently Asked Questions

General Questions

What AI model does WooBlurb use?

WooBlurb is powered by Claude, the most advanced AI language model from Anthropic. It's specifically optimized for understanding context, maintaining brand voice, and creating SEO-friendly content.

Do I need my own API key?

No! Your WooBlurb license key is all you need. We handle all API access through our secure servers, so you don't need to sign up for separate AI services or manage API keys.

Can I use WooBlurb on multiple sites?

Each license key is valid for one site. If you need WooBlurb on multiple sites, you'll need a separate license for each site. Contact us about multi-site licensing for agencies.

Will AI descriptions harm my SEO?

No! WooBlurb generates unique, high-quality content for each product. The AI creates original descriptions that are optimized for search engines, not duplicate content. In fact, many users see improved SEO after replacing thin product descriptions with WooBlurb's comprehensive copy.

Can I edit AI-generated descriptions?

Absolutely! Generated descriptions are fully editable. You can modify them like any other WordPress content. We recommend reviewing and personalizing descriptions to perfectly match your brand.

Credits & Pricing

How does the credit system work?

Simple: 1 credit = 1 product description, regardless of length, tone, or target field settings. If you generate descriptions for 100 products, you'll use 100 credits.

Do credits expire?

No, credits never expire. Buy credits whenever you need them and use them at your own pace.

What happens if I run out of credits?

You simply won't be able to generate new descriptions until you purchase more credits. Your existing descriptions remain unchanged, and you can still use all other WooBlurb features.

Are there refunds if I don't like a generated description?

Credits are deducted only after successful generation. If a generation fails, you don't lose credits. While we can't refund individual credits for successful generations, we're confident in our quality — most users are thrilled with the results!

Can I get credits refunded if I cancel?

Unused credits remain valid even if you don't renew your license. Your credits never expire, so you can use them anytime your license is active.

Technical Questions

Does WooBlurb work with variable products?

Yes! WooBlurb works with all WooCommerce product types: simple, variable, grouped, and external products. For variable products, enable "Include Product Attributes" in settings for best results.

Can I generate descriptions in languages other than English?

Currently, WooBlurb is optimized for English product descriptions. Support for additional languages is planned for future releases.

How long does generation take?

Single product generation typically takes 5-15 seconds. Bulk generation speed depends on your settings, but you can expect to process about 100-200 products per hour with default settings.

Will this slow down my site?

No. Description generation happens in the background and doesn't affect your site's frontend performance. Your customers won't experience any slowdown.

What hosting do I need?

WooBlurb works on most WordPress hosting, including shared hosting. For best bulk generation performance, we recommend at least 2GB RAM and PHP 7.4+. Managed WordPress hosting (like WP Engine, Kinsta) works great.

Can I schedule automatic generation for new products?

Currently, generation is manual. Automatic generation for new products is planned for a future update. For now, you can quickly generate descriptions when adding new products.

Content & Quality

How do I ensure descriptions match my brand voice?

Use the tone settings (Professional, Casual, Enthusiastic, Luxury) and Custom Instructions field. Add specific brand guidelines like "Always use 'we' instead of 'I'" or "Emphasize our family-owned heritage."

Can WooBlurb write descriptions for any product type?

Yes! The AI is trained on a vast range of products. From electronics to apparel, from food to software — WooBlurb can generate quality descriptions for virtually any product category.

What if the AI gets product details wrong?

The AI bases descriptions on the product data you provide (title, attributes, categories, tags). Ensure this data is accurate and complete before generating. You can always edit descriptions after generation.

Can I regenerate descriptions if I don't like them?

Yes, you can regenerate descriptions anytime. Each regeneration costs 1 credit. Try adjusting your settings (tone, length, custom instructions) for better results before regenerating.

Does WooBlurb include product specifications in descriptions?

Yes, if you enable "Include Product Attributes" in settings. The AI will naturally incorporate specifications like dimensions, materials, colors, and other attributes into the description.

Workflow Questions

Should I generate for all products at once?

For large catalogs, we recommend starting with a test batch of 10-20 products. Review the results, adjust settings if needed, then process the rest in batches of 50-100 products.

Can I pause bulk generation?

Yes! Go to WooBlurb → Batches and pause any running batch. You can resume it later without losing progress.

What's the best workflow for a new store?

  1. Add all product data (titles, categories, attributes, prices)
  2. Configure WooBlurb settings (tone, length, custom instructions)
  3. Generate descriptions for 5-10 test products
  4. Review and refine settings based on results
  5. Bulk generate remaining products in batches
  6. Review and publish descriptions

How often should I regenerate descriptions?

Generally, descriptions don't need regenerating unless:

  • Product details change significantly
  • You rebrand and change your tone/voice
  • You want to update for seasonal promotions
  • SEO strategy changes

Ready to Transform Your Product Catalog?

Generate professional product descriptions in minutes, not hours.

Get Started with WooBlurb