User Guide

To get started with WooWand:

1. Go to the registration page
2. Enter your email, username and password (8 characters minimum)
3. Add your company name (optional)
4. Enter your phone number
5. Click "Sign up"
6. You'll receive a verification code by SMS — enter it to validate your account

Your account is created with the Free plan (5 credits/month). No credit card required.

Log in with your email and password from the login page.

If you forgot your password, click "Forgot password" to receive a reset link by email. The link is valid for 24 hours.

The OAuth method is the simplest and most secure:

1. From your dashboard, go to Stores
2. Click Add a store
3. Enter your WooCommerce store URL (e.g. https://my-store.com)
4. Click Connect via OAuth
5. You'll be redirected to your WordPress admin
6. Click Approve to authorize WooWand
7. You're automatically redirected back to WooWand — your store is connected!

Your credentials never pass through our servers. The connection uses WooCommerce's official OAuth 1.0a protocol.

If OAuth doesn't work (some hosts block callbacks):

1. In your WordPress admin, go to WooCommerce > Settings > Advanced > REST API
2. Click Add key
3. Give it a name (e.g. "WooWand"), select a user with Administrator rights
4. Choose Read/Write permissions
5. Click Generate API key
6. Copy the Consumer Key and Consumer Secret (they won't be shown again)
7. In WooWand, click Manual connection, paste the URL, key and secret

Your keys are encrypted with AES-128 (Fernet) before being stored.

After connecting, WooWand automatically tests access to your store.

You can re-verify the connection at any time from Stores > your store > Verify connection.

Possible statuses:

• Connected: everything works
• Authentication error: your keys are invalid or revoked
• Unreachable: your site is offline or blocking API requests

WooWand generates meta title, meta description and focus keyword for each product. But these fields are only visible to Google if you have an SEO plugin installed on WordPress.

Without an SEO plugin, the meta tags won't be added to your HTML code — and Google won't see your optimizations.

WooWand automatically detects Yoast SEO and Rank Math. Both are free and excellent.

Yoast SEO is the most popular SEO plugin for WordPress (over 5 million active installations).

1. In your WordPress admin, go to Plugins > Add New
2. Search for "Yoast SEO"
3. Click Install Now then Activate
4. Follow the quick setup wizard (optional but recommended)
5. That's it! WooWand will automatically detect Yoast SEO on the next sync

Yoast SEO adds meta title, meta description and focus keyword fields to every WooCommerce product listing.

Rank Math is a modern alternative to Yoast, with more features in its free version.

1. In your WordPress admin, go to Plugins > Add New
2. Search for "Rank Math SEO"
3. Click Install Now then Activate
4. Follow the setup wizard (recommended)
5. In Rank Math settings, enable the WooCommerce module if not already enabled
6. WooWand will automatically detect Rank Math

Rank Math handles the same SEO fields as Yoast (meta title, description, focus keyword) and adds an SEO score directly in the product editor.

When connecting or syncing your store, WooWand automatically checks if Yoast SEO or Rank Math is installed.

You can see the detected plugin in your store details (Stores page).

If no plugin is detected, WooWand will still optimize the text, but the meta tags won't be published to your site.

Syncing imports all products from your WooCommerce store into WooWand.

1. Go to Stores > your store
2. Click Sync products
3. WooWand fetches all products via the WooCommerce API
4. Products appear in the Products tab

The sync respects WooCommerce's 10 requests/second rate limit to avoid overloading your server.

WooWand supports:

• Simple products: fully supported
• Variable products: the parent product and each variant are optimized individually

The following types are automatically skipped (status: SKIPPED):

• Grouped products: these are collections of existing products
• External/affiliate products: they point to an external site

Product slugs (URLs) are never modified to protect your SEO.

1. Go to Products and select a product
2. In the Text tab, click Optimize
3. The AI (Claude AI) analyzes your product and generates:
   • An SEO-optimized title (50-70 characters)
   • A punchy short description (< 155 characters)
   • A structured long description in HTML (H2, H3, lists)
   • A meta title for SEO (60 characters max)
   • A meta description (155 characters max)
   • A focus keyword
4. The result appears in the "Optimized" column next to the original

Optimization takes 10-30 seconds. 1 credit is consumed per successful optimization.

After optimization, you can:

• Text tab: view original and optimized side by side
• Comparison tab: stacked or side-by-side before/after view
• Preview tab: see the final rendering as it would appear on your WooCommerce store
• SEO tab: view meta tags, SERP preview (Google preview), and focus keyword

You can edit the generated content directly before publishing.

Every product receives a quality score out of 10, before and after optimization.

The score analyzes 8 criteria:

1. Title length and keywords
2. Short description quality
3. Long description length and structure
4. HTML validity and heading hierarchy
5. Image count and resolution
6. Keyword density and natural distribution
7. Content uniqueness
8. Category relevance

The goal is to go from scores of 2-4 to 7-9+.

Keyword research is available from the SEO tab of each product.

1. Open a product
2. Click the SEO tab
3. Use the search field to find keywords
4. Results show monthly search volume, SEO difficulty, and estimated CPC

Data comes from DataForSEO, one of the most reliable SEO data providers on the market.

Each keyword displayed includes:

• Volume: number of monthly Google searches
• Difficulty: score from 0 to 100 (0 = easy to rank, 100 = very competitive)
• CPC: estimated cost per click in Google Ads (indicates the keyword's commercial value)

Prioritize keywords with good volume, moderate difficulty (< 50), and high CPC — they have the best conversion potential.

WooWand also suggests related keywords and long-tail phrases.

Long-tail keywords are longer, more specific expressions (e.g. "organic cotton summer dress women" instead of "summer dress"). They have less volume but convert better.

Use them to enrich your product descriptions and capture more qualified traffic.

The SERP preview shows you how your product will appear in Google search results.

It displays:

• The meta title (in blue, clickable)
• The page URL
• The meta description (in gray)

This lets you verify that your meta tags are well-formatted and attractive before publishing.

WooWand offers several image generation styles:

• Studio: clean white or gray background, professional e-commerce look
• Lifestyle: product in use context, aspirational setting
• Packshot: product + packaging view, technical precision

Choose the style in the product's Images tab, add a custom prompt if desired, then click Generate.

Generation takes 30-60 seconds. 1 credit per image.

Packshot mode generates 4 complementary images in one click:

1. Front view with model
2. Product alone on neutral background
3. Lifestyle setting (front view)
4. Lifestyle setting (profile view)

Ideal for filling your product gallery in a single operation. Costs 4 credits (1 per image).

WooWand also offers a second image generator: Nano-Banana (via kie.ai).

Two models are available:

• nano-banana: fast, good for testing
• nano-banana-pro: better quality, more detail

These images are accessible in the dedicated section of the Images tab. They offer a different style — try both to find the best fit for your products.

Once your images are generated:

1. Preview them in the gallery
2. Click Publish images
3. WooWand uploads them to your store's WordPress media library
4. They are automatically assigned to the product

For upload to work, you must have configured your WordPress credentials (username + application password) in the store settings.

Videos are generated by Kling 3.0 via kie.ai:

1. Open a product and go to the Video tab
2. Write a prompt describing the desired video
3. (Optional) Click Optimize prompt — Claude AI will automatically improve your description
4. Choose the settings:
   • Format: 16:9 (landscape), 9:16 (portrait for mobile/social), 1:1 (square)
   • Duration: 3, 5, 8, 10 or 15 seconds
   • Mode: Standard (fast) or Professional (high resolution)
5. (Optional) Add a reference image — it will be used as the first frame
6. Click Generate video

Video generation takes a few minutes. You can track the status in real time:

• Waiting: your job is in the queue
• Processing: the video is being generated
• Complete: your video is ready — you can preview and download it
• Failed: an error occurred — no credits are consumed

The page automatically refreshes until generation is complete.

All videos generated for a product are listed in the Video tab.

For each video, you can:

• Preview it with the built-in player
• Download it in MP4 format
• Delete it if it doesn't suit your needs

Videos are stored securely and remain accessible as long as your account is active.

After reviewing and validating the optimizations:

1. Click Publish on the product page
2. WooWand sends the optimized text to your WooCommerce store via the REST API
3. Fields updated: title, short description, long description
4. If an SEO plugin is detected: meta title, meta description and focus keyword are also published

The product slug (URL) is never modified.

If you change your mind after publishing, use Rollback (see next section).

To publish generated images:

1. Make sure your WordPress credentials are configured (Stores > your store > WP Credentials)
2. In the Images tab, click Publish images
3. Images are uploaded to the WordPress media library
4. They are assigned as product images

Note: you need to create a WordPress application password. In your WordPress admin: Users > your profile > Application Passwords > Add New.

WooWand automatically saves the original version of each product before any optimization.

To restore the original:

1. Open the product
2. Click the Rollback button
3. Confirm the restoration
4. The product reverts to its original version

Rollback is available even after publishing to WooCommerce.

Rollback restores:

• Original title
• Original short description
• Original long description (HTML)
• Original image
• Original meta title and meta description

The optimization history is kept even after a rollback — you can still view previous versions.

Templates define the AI's writing style for your optimizations.

1. Go to Templates from the sidebar menu
2. Click New template
3. Give it a name (e.g. "Minimalist luxury", "Dynamic sport")
4. Choose the tone from preset options
5. Add custom instructions (optional)
6. Click Create

Your templates are reusable across all your products.

WooWand offers 6 preset tones:

• Professional: formal vocabulary, expert phrasing
• Friendly: warm, approachable tone
• Luxurious: elegant, refined, high-end
• Minimalist: concise, clean, essential
• Dynamic: energetic, modern, punchy
• Technical: precise, detailed, specifications-focused

You can also write free-form instructions to fine-tune the style.

Custom instructions let you go further:

Examples:

• "Always mention the material and origin of the product"
• "Target women aged 25-35"
• "Use informal language"
• "Never use superlatives (best, unique, etc.)"
• "Mention free shipping in the short description"

The AI will follow these instructions for every product optimized with this template.

To optimize multiple products at once:

1. Go to Products
2. Use the checkboxes to select the desired products
3. Click Bulk optimize in the action bar
4. Choose a template (optional)
5. Launch the optimization

Products are processed in parallel based on your plan:

• Free: 1 simultaneous
• Starter: 3 simultaneous
• Pro: 10 simultaneous

Each product consumes 1 credit. You can track progress in the History page.

Automate your product optimizations:

1. Go to Schedules from the sidebar menu
2. Click New schedule
3. Select the store
4. Choose the frequency: daily, weekly, or monthly
5. Set the max products per run
6. (Optional) Select a template to apply
7. Click Create

The schedule will run automatically at the chosen frequency.

From the Schedules page, you can:

• Pause a schedule
• Resume a paused schedule
• Edit the frequency or product count
• Delete a schedule

Each schedule shows the last run date and the next scheduled run.

The dashboard displays:

• Average quality score of your products
• Remaining credits this month
• Product count (total and optimized)
• Connected stores
• Activity chart for the last 14 days
• Recent optimizations (5 most recent)
• Onboarding checklist (account, store, sync, optimize)

KPIs update in real time.

The Analytics page offers detailed views:

• Optimizations per day (chart over 7, 30, or 90 days)
• Credits consumed per day
• Breakdown by type (text, image, video)
• Breakdown by status (success, failed, processing, pending, canceled, retry)
• Score comparison before/after in bar charts

The History page lists all optimization jobs:

• Type (text, image, video)
• Status (success, failed, processing, pending, canceled, retry)
• Product concerned
• Store
• Credit cost
• Created and completed dates

You can filter by store and export history as CSV for your analysis.

WooWand offers 3 plans:

Free — €0/month

• 5 credits/month
• 1 store
• AI text optimization
• Rollback

Starter — €29/month

• 50 credits/month
• 3 stores
• AI text + images
• Email support

Pro — €99/month

• 200 credits/month
• Unlimited stores
• AI text + images + video
• Priority support
• API access

Credits are WooWand's unit of measure:

• 1 text optimization = 1 credit
• 1 image generated = 1 credit
• 1 video generated = 2 credits

Credits reset at the start of each billing cycle. Unused credits don't roll over.

You can also buy top-up credit packs (20, 50, or 100) from the Billing page — these credits never expire.

A notification is sent when you have 20% of your credits remaining.

From Billing:

• Upgrade: immediate, you get the extra credits right away
• Downgrade: takes effect at the end of the current period
• Cancel: one click, no commitment. You switch to the Free plan at the end of the period

Payment is by card via Stripe. No banking data is stored on our servers.

All your invoices are accessible from Billing > Invoices.

Each invoice shows the date, amount, status (paid/unpaid), and a PDF download button.

To manage your payment method or cancel, use the Manage subscription button which opens Stripe's secure portal.

From Settings > Profile, you can edit:

• Username
• First and last name
• Company name

Click Save to apply changes.

From Settings > Password:

1. Enter your current password
2. Enter the new password (8 characters minimum)
3. Confirm the new password
4. Click Change password

From Settings > Notifications, enable or disable emails for:

• Optimization completed successfully
• Optimization failed
• Low credits (< 20%)
• Payment failed
• Store disconnected

In-app notifications are always active and accessible from the bell icon in the dashboard.

In compliance with GDPR, you can export all your personal data:

1. Go to Settings > Privacy
2. Click Export my data
3. A JSON file containing all your information is downloaded

The file contains your profile information, stores, products, optimization history, and settings.

To permanently delete your account:

1. Go to Settings > Privacy
2. Click Delete my account
3. Confirm the deletion

Deletion is immediate and irreversible. All your data (stores, products, history) will be deleted within 24 hours in accordance with GDPR.

Check the following:

1. The URL is correct: it must be the full URL of your store (https://my-store.com)
2. WooCommerce is installed and activated on your WordPress site
3. The REST API is enabled: WooCommerce > Settings > Advanced > REST API
4. Permalinks are configured: WordPress > Settings > Permalinks > choose a format other than "Plain"
5. Your host isn't blocking API requests: some hosts have strict firewalls. Contact your host if needed

If OAuth doesn't work, try the manual connection method.

Possible causes:

• Store unreachable: verify your site is online. WooWand automatically retries 3 times
• Not enough credits: check your balance in Billing
• Incompatible product: grouped and external products are skipped
• Temporary AI API error: try again in a few minutes

No credits are consumed for failed optimizations. You receive a notification when a job fails.

Available options:

1. Wait for renewal: credits reset at the start of your next billing cycle
2. Buy a pack: from Billing, purchase additional credits (20, 50, or 100)
3. Upgrade your plan: to get more monthly credits

You receive an email alert when you have 20% of your credits remaining.

If the quality score isn't increasing significantly:

1. Check images: the score takes image count into account. Generate images to gain points
2. Add target keywords: use SEO research to identify the right keywords
3. Use a template: a template with specific instructions gives better results
4. Complete WooCommerce attributes: categories, tags, price — the AI uses this information for context

A score of 7-8/10 is excellent. A score of 9-10 is exceptionally rare.