Ever checked your WooCommerce dashboard and realized you’re out of stock on your best seller? Or worse, you’ve got thousands of dollars tied up in products that haven’t moved in months?

If you’re running a WooCommerce store with more than a few hundred products, you’ve felt this pain. Manual inventory management doesn’t scale. Spreadsheets break. And guessing when to reorder leads to either stockouts or overstock — both of which cost you money.

That’s where StockOracle AI comes in. It’s an intelligent inventory management plugin for WooCommerce that analyzes your sales velocity, supplier lead times, and seasonal trends to calculate dynamic reorder points. It replaces chaotic spreadsheets with automated precision — and it lives entirely inside your WordPress dashboard.

In this tutorial, I’ll walk you through the complete StockOracle AI setup process. Whether you’re using the free version or the Pro plan with AI forecasting, by the end of this guide you’ll have your inventory health score, reorder alerts, and demand forecasts running on autopilot.

What You Need Before Starting StockOracle AI Setup

Before we dive into the setup, let’s make sure your environment is ready.

Prerequisites

• WooCommerce 8.0+ installed and active (HPOS recommended for best performance)
• WordPress 6.0+
• PHP 7.4 or higher
• A StockOracle AI license key (free or Pro — you can grab the free version from WordPress.org or purchase Pro at themefreex.com)

StockOracle AI reads directly from your WooCommerce order data and product catalogue. It doesn’t require any external API keys for the free version — everything runs locally on your server. If you’re using the Pro AI forecasting feature, you’ll need your own OpenAI or Anthropic API key (more on that later).

One important note: StockOracle AI is fully compatible with WooCommerce High-Performance Order Storage (HPOS). If you’ve enabled HPOS on your store, the plugin will use wc_order_product_lookup for performance-optimised queries. If HPOS is disabled, it falls back to legacy order item tables automatically.

Step 1: Install and Activate StockOracle AI

Let’s get the plugin onto your site.

Installing the Free Version

1. Go to your WordPress admin dashboard.
2. Navigate to Plugins → Add New.
3. Search for “StockOracle AI”.
4. Click Install Now, then Activate.

That’s it. The free version is ready to go. You’ll see a new menu item called StockOracle in your WordPress admin sidebar.

Installing the Pro Version

If you’ve purchased the Pro version, you’ll receive a license key by email after checkout. Here’s how to install it:

1. Download the plugin ZIP file from your account on themefreex.com.
2. Go to Plugins → Add New → Upload Plugin.
3. Choose the ZIP file and click Install Now.
4. Activate the plugin.
5. Go to StockOracle → License and paste your license key.
6. Click Activate License.

Your license is managed via YITH Subscriptions. It renews automatically, and your license key is extended on each successful renewal. If the subscription is cancelled or expires, the license is revoked — but your existing data and settings remain intact.

Step 2: Configure General Settings

Once activated, head to StockOracle → Settings. This is where you’ll define how the plugin behaves.

Basic Settings

• Low Stock Threshold: Set the quantity at which a product is considered “low stock.” Default is 10. Adjust based on your sales velocity.
• Out of Stock Threshold: Set the quantity at which a product is considered “out of stock.” Default is 0.
• Dead Stock Days: Define how many days of zero sales qualify a product as “dead stock.” Default is 90 days.
• Safety Stock Days: Buffer stock to cover unexpected demand spikes. Default is 7 days.
• Default Supplier Lead Time: Average number of days your suppliers take to deliver. Default is 14 days.

These settings directly impact your reorder point calculations and inventory health score. Take time to set them based on your actual business data. If you’re unsure, start with the defaults and adjust as you gather more data.

Email Notification Settings

StockOracle AI can send you automated alerts when stock levels hit critical thresholds. Under Settings → Email Notifications, you can:

• Enable or disable weekly digest emails.
• Set the email recipient (defaults to the admin email).
• Choose which alert levels trigger notifications: Critical, Warning, or Info.

I recommend enabling the weekly digest at minimum. It gives you a bird’s-eye view of your inventory health without overwhelming your inbox.

Step 3: Understand the Inventory Health Dashboard

Now for the good stuff. Navigate to StockOracle → Dashboard. This is your command center.

The Inventory Health Score is an A–F grade calculated from five metrics:

• Stockout Rate: Percentage of products currently out of stock.
• Low Stock Rate: Percentage of products below your low stock threshold.
• Dead Stock Rate: Percentage of products with zero sales in the defined period.
• Daily Velocity Coverage: How many days your current stock will last at current sales velocity.
• Reorder Point Accuracy: How well your reorder points align with actual demand.

The dashboard also shows:

• Total products tracked
• Products with active reorder alerts
• Stockout count
• Low stock count
• Dead stock count

This is your at-a-glance inventory health report. Check it weekly to spot trends before they become crises.

Step 4: Set Up Reorder Alerts

Reorder alerts are the heart of StockOracle AI. They automatically notify you when a product needs restocking based on your settings.

Go to StockOracle → Reorder Alerts. You’ll see three categories:

• Critical: Products that are out of stock or below safety stock. Act immediately.
• Warning: Products approaching reorder point. Plan your next purchase order.
• Info: Products with sufficient stock but worth monitoring.

Each alert shows the product name, current stock, sales velocity (daily average), and calculated reorder point. Click on any product to see detailed sales history and trend charts.

You can also manually set reorder points for individual products from the product edit screen. StockOracle AI will override your manual point if it detects a significant change in sales velocity.

Step 5: Run ABC Inventory Classification

ABC analysis helps you focus on your most profitable products. StockOracle AI automatically classifies your inventory into three categories:

• A-Class: Top 20% of products by revenue. These are your cash cows. Apply strict inventory controls here.
• B-Class: Next 30% of products. Moderate controls.
• C-Class: Bottom 50% of products. Minimal controls — focus on preventing dead stock.

Go to StockOracle → ABC Analysis to view the classification. The plugin calculates this based on your historical sales data. You can override classifications manually if needed.

Using ABC classification, you can prioritize your purchasing efforts. For A-class products, set tighter reorder points and lower safety stock. For C-class products, consider reducing order quantities or eliminating slow movers altogether.

Step 6: Enable Demand Forecasting (Pro Feature)

If you’re using StockOracle AI Pro, you can unlock AI-powered demand forecasting. This feature uses your own OpenAI or Anthropic API key to generate hyper-accurate predictions.

Setting Up AI Forecasting

1. Go to StockOracle → Settings → AI Forecasting.
2. Enable the feature.
3. Enter your OpenAI or Anthropic API key.
4. Select the forecasting model (GPT-4 or Claude 3.5 recommended for best accuracy).
5. Click Save Changes.

Once enabled, StockOracle AI will analyze your historical sales data — including seasonality, trends, and contextual factors — to project 30-day demand, calculate precise daily averages, and suggest exact restock quantities.

Important: Only anonymised, aggregated sales numbers are sent to the AI provider. No customer names, emails, or order details are ever transmitted. Your data stays on your server.

The free version includes SMA (Simple Moving Average) and WMA (Weighted Moving Average) algorithms for baseline forecasting. These are mathematically robust and don’t require any external API calls.

Step 7: Manage Dead Stock

Dead stock is capital sitting on your shelves that could be working for you. StockOracle AI automatically detects products that haven’t sold in your defined period (default 90 days).

Go to StockOracle → Dead Stock. You’ll see a list of dead stock products with:

• Days since last sale
• Current stock quantity
• Total capital tied up
• Recommendations (liquidation, promotion, or removal)

Use this data to make informed decisions. Consider running clearance sales, bundling dead stock with popular items, or donating to charity for a tax write-off. The goal is to free up cash and warehouse space.

Step 8: Set Up Automated Purchase Orders (Pro Feature)

Pro users can generate and email purchase orders directly from WooCommerce. This streamlines your restocking process.

Go to StockOracle → Purchase Orders. Click Create New.

• Select a supplier from your CRM (or add a new one).
• Choose products to order (the plugin suggests quantities based on reorder points).
• Set expected delivery date.
• Generate a PDF or send via email.

Track order statuses from draft to expected delivery. Export records as CSV for accounting. This eliminates the back-and-forth of manual purchase order creation.

Step 9: Configure Supplier CRM (Pro Feature)

Keep all your vendor information organized in one place. Go to StockOracle → Suppliers.

Add each supplier with:

• Name and contact details
• Lead time (days)
• Minimum order value
• Payment terms
• Notes

Once set up, StockOracle AI uses supplier lead times to calculate reorder points. If a supplier has a 30-day lead time, the plugin will alert you 30 days before you run out of stock — not 7 days.

Step 10: Schedule Email Reports (Pro Feature)

Keep yourself and your team informed without checking the dashboard daily. Go to StockOracle → Settings → Email Reports.

Configure:

• Frequency: Weekly or monthly
• Recipients: Add multiple email addresses
• Content: Choose which sections to include (low stock alerts, top sellers, dead stock, etc.)

Reports are delivered as beautifully formatted HTML emails. You can also generate print-ready PDF reports for meetings or audits.

Common Pitfalls and How to Avoid Them

Setting up inventory automation isn’t without challenges. Here are the most common issues I’ve seen — and how to fix them.

Pitfall 1: Incorrect Lead Times

If your supplier lead times are wrong, your reorder points will be off. Always verify lead times with your suppliers. Start with conservative estimates and adjust as you gather data.

Pitfall 2: Ignoring Seasonality

StockOracle AI’s Pro AI forecasting handles seasonality automatically. But if you’re using the free version, you need to account for seasonal spikes manually. Consider setting higher safety stock during peak seasons.

Pitfall 3: Not Reviewing Alerts Regularly

Reorder alerts are useless if you don’t act on them. Set a recurring calendar reminder to review your alerts weekly. Even 10 minutes can prevent a costly stockout.

Pitfall 4: Over-relying on Automation

Automation is a tool, not a replacement for judgment. Always review AI-generated forecasts and purchase orders before executing. Market conditions change, and your brain is still better at spotting anomalies than any algorithm.

StockOracle AI vs. Competitors: Why Self-Hosted Wins

You might be wondering: why use StockOracle AI instead of a SaaS like Katana ($99/month) or TradeGecko ($39–$599/month)?

The answer is simple: data sovereignty and cost.

StockOracle AI runs entirely on your own server. Your inventory data never leaves your control. No monthly SaaS fees. No vendor lock-in. You pay once (or annually) and own the software forever.

Compare that to Katana, which starts at $99/month. That’s $1,188/year for a basic plan. StockOracle AI Pro starts at $49/month or $1,499 lifetime. For most small-to-mid-size WooCommerce stores, the self-hosted approach saves thousands over three years.

And unlike ATUM (a free but basic inventory plugin), StockOracle AI gives you AI-powered forecasting, automated purchase orders, and a supplier CRM — features you’d normally pay enterprise prices for.

Take Action: Start Your StockOracle AI Setup Today

Inventory management doesn’t have to be a headache. With StockOracle AI, you can stop reacting to stockouts and start proactively managing your inventory with data-driven precision.

Here’s your next step: Download StockOracle AI Pro and follow this tutorial. Start with the free version to get a feel for the dashboard, then upgrade to Pro when you’re ready for AI forecasting, purchase orders, and supplier management.

Your inventory health score is waiting. Don’t let another stockout cost you a sale.