AI Suggestions for Product Documentation¶
Menu Location: AI > AI Suggestions for Product
Access Level: Administrator and above
Last Updated: 2026-03-02
Overview¶
The AI Suggestions for Product page (ai-suggestions.php) is an AI-powered product catalog improvement tool. It analyzes products using AI and generates specific improvement suggestions for product names, descriptions, categories, tags, SEO metadata, shop filters, and more. Each suggestion goes through a review workflow where it can be individually approved or rejected.
Primary Functions:
- Generate AI-powered improvement suggestions for products
- Review suggestions with side-by-side current vs. suggested values
- Approve or reject individual suggestions
- Track suggestion batch history with implementation status
- Character-level diff highlighting for text changes
Page Layout¶
Header¶
- Page Title: "AI \ Suggestions"
- Get Suggestions Button: Triggers AI analysis of products (pull-right)
- Info Button: Shows/hides the welcome message
Welcome Screen (First Visit)¶
A centered card explaining the feature:
- AI reviews your products
- Generates improvement suggestions
- You review and approve changes
- Approved updates are applied instantly
Dismissible per-user (saved via config). Click "Get Your First Suggestions" to start.
Batch List View¶
Table showing all suggestion groups:
| Column | Description |
|---|---|
| (indicator) | Blue dot for unreviewed batches |
| Name | Product name associated with the batch |
| Pending | Count of unreviewed suggestions |
| Implemented | Count of approved suggestions |
| Rejected | Count of rejected suggestions |
| (date) | When the batch was generated |
Click any row to enter the review interface.
Review Interface (Detail View)¶
Loaded via AJAX from reviewdiv.php:
- Shows each suggestion with current value vs. suggested value
- Diff highlighting for text changes
- Approve/Reject buttons for each suggestion
- Navigation between suggestion batches
How to Use¶
Generating Suggestions¶
- Click the "Get Suggestions" button in the header
- A loading modal appears while the AI analyzes products
- The page refreshes with new suggestions highlighted (green row)
- New batches appear at the top of the list
Reviewing Suggestions¶
- Click on a batch row in the list view
- The review interface loads showing each suggestion
- For each suggestion, compare current vs. suggested values
- Click Approve to apply the change or Reject to keep the current value
- Navigate between products/batches as needed
Understanding the Diff¶
- Green highlighted text: New content being added
- Orange highlighted text: Content being changed (shows old value)
- Red highlighted text: Content being removed
- Yellow character highlighting: Individual character differences
Managing the Welcome Message¶
- Click the X button on the welcome card to dismiss it
- Click the info icon in the header to bring it back
What Gets Suggested¶
The AI can suggest improvements for:
| Field | Description |
|---|---|
| Product Name | Improved naming for clarity and SEO |
| Description | Enhanced product descriptions |
| Brand | Brand/category classification |
| Distributor | Vendor/supplier assignment |
| Units | Unit of measure corrections |
| SEO Title | Search engine optimized page titles |
| SEO Description | Meta descriptions for search results |
| SEO Keywords | Target keywords for the product |
| Shop Filters | Filter category assignments |
| Product Tags | Tag assignments for categorization |
Common Use Cases¶
New Product Catalog Setup¶
After adding products, run AI suggestions to automatically generate descriptions, tags, filters, and SEO metadata in bulk.
Product Description Enhancement¶
Periodically run suggestions to improve product descriptions with better copy, keywords, and selling points.
SEO Optimization¶
Let the AI suggest improved page titles, meta descriptions, and keywords for products that aren't ranking well.
Catalog Standardization¶
Use suggestions to standardize naming conventions, categorization, and tagging across the product catalog.
Tips & Best Practices¶
- Review suggestions carefully before approving - AI suggestions are recommendations, not guarantees
- Start with a small batch to understand the quality of suggestions
- Approving SEO changes clears the page cache automatically
- New vendors and units are created automatically if the AI suggests ones that don't exist
- Use the pending/implemented/rejected counts to track progress
- The blue dot indicator helps identify batches that haven't been reviewed yet
- Suggestions are grouped by the API call that generated them (open_ai_api_id)
Troubleshooting¶
"Get Suggestions" Button Doesn't Respond¶
- Check for JavaScript errors in the browser console
- Ensure the OpenAI API key is configured
- Wait for any in-progress requests to complete
Suggestions Seem Incorrect¶
- AI suggestions are based on product data and general knowledge
- Reject any suggestions that don't fit your brand or product line
- The AI avoids duplicating recent suggestions
Approved Changes Not Appearing¶
- Check the system log for confirmation of the update
- Clear browser cache and Cloudflare cache for the affected pages
- Verify the product still exists in the catalog
Database¶
Primary Table: ai_site_improvements
| Field | Description |
|---|---|
| id | Unique identifier |
| row_id | Product (menu) ID |
| table | Target database table |
| field | Target field name |
| current | Current value |
| suggestion | AI-suggested value |
| implemented | Status: 0=pending, 1=approved, -1=rejected |
| open_ai_api_id | Groups suggestions from the same API call |
| created | Timestamp |
FAQ¶
How many suggestions are generated per run?¶
Each run analyzes one or more products and generates multiple field-level suggestions per product.
Can I re-run suggestions for the same product?¶
Yes, clicking "Get Suggestions" again will generate new suggestions. Previous batches remain in the history.
What happens when I approve a suggestion?¶
The change is applied immediately to the database via process_improvements.php. The suggestion is marked as implemented.
Can I undo an approved suggestion?¶
There's no automatic undo. Check the system log for the previous value and manually revert if needed.
Related Pages¶
- AI Improvements RAW (
process_improvements.php) - Backend handler for approvals - Products - Product catalog management
- Product Tags - Tag management
- Store Categories - Category management
- API Calls - AI API call log