Documentation
Complete guide to setting up and using ListNovate AI with WooCommerce.
Installation
ListNovate AI operates as a hybrid system: A cloud dashboard (where you manage billing) and a WordPress plugin (where you manage products).
- Download the plugin from the Download Page.
- Go to your WordPress Admin → Plugins → Add New → Upload Plugin.
- Activate "ListNovate AI".
Connecting API Keys
To enable AI processing, you must connect the plugin to your account.
1. Generate Key
Go to your ListNovate Dashboard, navigate to "API Keys", and create a new key.
2. Paste in Plugin
In WordPress, go to ListNovate AI → Settings. Paste the key and click "Test Connection".
The Workflow
Staging & Galleries
The Staging Area is a sandbox. Changes here do not affect your live store until you click Upload.
Feature: Image Stacking
To create a product with multiple images (Gallery), simply drag one product card on top of another in Grid View. The system will ask to confirm the merge. The bottom card becomes the "Parent" and the dragged card becomes a gallery image.
How to Import Images
The Staging Area is where you prepare your media. Choose the method that best fits your workflow:
Drag and Drop
Simply select images from your computer and drag them directly into the staging area. Ensure your files are in supported formats like JPG, PNG, or WebP.
"Select Images" Button
Click the button to open your file explorer. You can bulk-select product images for automatic import.Pro tip: Use this method to quickly add multiple individual items at once.
"Select Folder" Button (Bulk Import)
Ideal for large inventories. This feature mirrors your local folder structure to automate product creation.
Preparation Steps:
- 01.Create a Parent Folder (e.g.,
uploads/). - 02.Create Subfolders for each product inside the parent.
- Inside each subfolder, name your main cover image
root. This is how our system identifies the primary product photo. - Optional: For extra photos, create a folder named
gallery(lowercase) and place them inside.
// Structure
uploads/
└── product-name/
├── root.jpg (Required. JPG, PNG, or WebP )
└── gallery/ (Optional)
Note: Windows users can useMicrosoft PowerToysto bulk-rename images to "root" instantly.
AI Generation & Context
Before running AI, you should set the Context. This tells the AI *who* you are selling to.
- Target Country: Determines currency, spelling (Color vs Colour), and cultural nuances.
- Tone: Select "Luxury," "Urgent," "Friendly," etc.
- Keywords: SEO terms you want forced into the description.
Bulk Actions
Select multiple products using the checkboxes or Shift+Click. The top toolbar will activate.
Math Operations
You can increase/decrease prices by a percentage (e.g., +20% markup) or add a fixed amount (e.g., +$5 shipping) to 100+ items instantly.
Variations
Double-click a card to enter "Editor Mode". Here you can change the product type to "Variable", generate attributes (Size, Color), and drag specific images to specific variation rows.
Validation & Status
ListNovate AI prevents "Dirty Data" from entering WooCommerce. Pay attention to card borders:
Multi-Vendor Integration
ListNovate allows you to assign products directly to specific vendors right from the staging area. Enable Multi-Vendor support in the plugin Settings to start using this feature.
Supported Natively
The plugin automatically detects users with the following roles:
- administrator (Core)
- seller (Dokan)
- wcfm_vendor (WCFM)
- vendor (WC Vendors)
- dc_vendor (MultiVendorX)
Custom Roles & Extensibility
If you are using a custom membership plugin or a custom multi-vendor role, you can easily expose it to ListNovate AI using our built-in WordPress filter.
/** * Add a custom role to the allowed vendor roles list. * @param array $roles The default array of allowed role slugs. * @return array The updated array of role slugs. */add_filter('listnovate_ai_allowed_vendor_roles', 'add_custom_merchant_role');function add_custom_merchant_role( $roles ) {// Add your custom role slug to the array$roles[] = 'premium_merchant';return $roles;}
Credits & Billing
We use a 3-tier credit system to ensure your store never stops running, even if you forget to renew.
Free Daily Fallback (Safety Net)
Every account receives Free Daily Credits, which are always used first, even if you have Monthly or Top-Up credits. If you’re on a paid plan, you still retain access to your plan’s features (such as high-quality processing). Once the free daily credits are exhausted, the system moves on to paid credits.
Monthly Credits (Paid Plans)
These come with your subscription plan and expire at the end of each billing cycle. They are used after your free daily credits run out.
Top-Up Credits (Rollover)
These are purchased separately and never expire. They are used after both free daily and monthly credits are exhausted.
Troubleshooting
If you experience any issues while using the plugin, please review the solutions below. We continuously update this section to address known issues and improve reliability.
- Settings or credit balance not saving or reflecting in the plugin UI: This is commonly caused by aggressive caching. Performance plugins such as LSCache, WP Rocket, or server-level caching may prevent real-time updates from appearing. Please clear your website cache, browser cache, and CDN cache (if applicable), then reload the page.
- Internal server errors when using the plugin: Ensure your website is running the recommended PHP and WordPress versions listed on the download page. If the issue persists, it may be due to a conflict with another plugin or theme. Temporarily enable safe mode or deactivate other plugins to isolate the conflict.
- Slow performance or timeout errors: Check your hosting plan resources (memory limit, execution time, CPU usage). Low-tier hosting environments may struggle during high traffic or background processing tasks.