AI Fill Categories - Feature Guide

The AI Fill Categories tool automatically populates your store categories with products from any merchant (e.g. Amazon, eBay, AliExpress, Etsy, Walmart). Instead of manually searching and importing products one category at a time using the Product Finder, this tool lets you fill all your categories in one click.

How to Access

There are two ways to reach the Fill Categories tool in your store dashboard:

1. From the sidebar: Navigate to Products → AI Tools → Fill Categories
2. From the Category list: If you already have categories, click the Fill Categories button in the header (this button replaces the "Category Builder" button once categories exist)

Form Fields

Step-by-Step Guide

1. Navigate to Products → AI Tools → Fill Categories
2. Select your Merchant (e.g. Amazon)
3. Choose the Locale (e.g. US, UK, DE)
4. Set the Products per Category count. Start with a small number like 2–5 for testing
5. Toggle Generate AI Content on if you want product descriptions written automatically
6. Review the Categories checklist. By default, only leaf categories (those with no subcategories) are selected, which is usually what you want.
7. Click Fill Categories
8. You will see a success notification and be redirected to the Categories list

How It Works (Behind the Scenes)

For each selected category, a background job is dispatched that:

1. Generates a search keyword - AI converts the category title into an optimised merchant search term (e.g. "Men's Athletic Footwear" becomes "mens running shoes")
2. Searches the Merchant - Searches up to 5 pages of results using that keyword
3. Skips duplicates - Any product that already exists in your store (matched by offer ID and locale) is skipped
4. Imports new products - Each new product is added separately in the background
5. Stops at the limit — Once the requested quantity of new products has been dispatched, it stops

Tips & Best Practices

• Start small: Set quantity to 2 to 5 per category for your first run to check the results before doing a larger import
• Use leaf categories: The default selection of leaf categories (no subcategories) is intentional. These are the most specific categories and will produce the best search results
• No duplicates: Running the tool multiple times is safe. It will only import products that don't already exist in your store
• AI content uses chips: If "Generate AI Content" is enabled, each product will use AI chips for content generation
• Category names matter: Since the tool uses AI to derive search keywords from category names, having clear and descriptive category names (e.g. "Wireless Bluetooth Headphones" rather than "Category 1") will produce much better results
• Check the Products: You might get some products that are not relevant to the category. Check them in the products list, and delete them as needed.

Recommended Workflow

1. First, use the Category Builder to create your store categories with AI
2. Then, use Fill Categories to populate them all with products in one go
3. Review the imported products and make any adjustments
4. Use the Product Finder for any additional targeted product searches

Troubleshooting