Preview and Execute
📋 Overview
After setting up your filters and selecting an action, you must preview the affected products before executing the operation. This critical step helps you verify that the correct products are selected.
Never skip the preview! The preview step is your only chance to verify the selection before making irreversible changes.
📊 The Complete Workflow
👁️ Step 1: Preview Affected Products
Why Preview is Important
The preview shows you exactly which products will be affected by your bulk operation BEFORE any changes are made.
Preview helps you:
- ✅ Verify your filter selection is correct
- ✅ Check the number of affected products
- ✅ Identify any unexpected products in the selection
- ✅ Catch mistakes before they happen
- ✅ Build confidence before executing irreversible operations
The system enforces preview as a safety measure. You cannot execute without previewing first.
How to Preview
- ✅ Set up your filters (at least one filter required)
- ✅ Select your action (Add/Update/Remove)
- ✅ Fill in any required/optional fields for your action
- ✅ Click the "Preview Affected Products" button
What happens:
- The system queries your database with the current filter settings
- A loading indicator appears briefly
- The preview panel slides into view below the form
Understanding the Preview
The preview panel displays comprehensive information about the affected products:
Product Count
The total number of products matching your filters is displayed prominently:
12 products will be affected
or for large result sets:
125 products will be affected (showing first 100)
If more than 100 products match your filters, only the first 100 are displayed in the preview. However, ALL matching products will be affected when you execute.
Product List Table
The table shows detailed information for each product:
| Column | Description | Purpose |
|---|---|---|
| ID | Product ID number | Unique identifier |
| Reference | Product reference/SKU | Easy identification |
| Product Name | Product name in your current language | Human-readable identification |
Example preview table:
╔════╤═══════════╤════════════════════════════╗
║ ID │ Reference │ Product Name ║
╠════╪═══════════╪════════════════════════════╣
║ 45 │ DEMO-001 │ Professional Power Drill ║
║ 46 │ DEMO-002 │ Cordless Impact Driver ║
║ 47 │ DEMO-003 │ Hammer Drill Kit ║
╚════╧═══════════╧════════════════════════════╝
Use the Reference column to quickly verify you're affecting the correct products. References are often easier to identify than product IDs.
No Products Found
If your filters don't match any products, you'll see:
No products match the selected filters.
Common reasons:
Filter combination too restrictive
You've combined too many filters, resulting in zero matches.
Solution: Remove some filters and try again.
Selected category has no products
The category you selected is empty or inactive.
Solution: Check category in Catalog → Categories to verify it has products.
All products already have videos
When filtering for "Without Videos", all products already have videos.
Solution: Change "Has Videos" filter to "All" or "With Videos".
Manufacturer has no products in chosen category
The combination of manufacturer + category has zero products.
Solution: Use manufacturer OR category, not both, or verify the combination is correct.
✅ Step 2: Verify Your Selection
Before executing, ask yourself these critical questions:
Are These the Correct Products?
Check:
- ✅ Review product names and references
- ✅ Verify the count makes sense
- ✅ Look for any unexpected products
- ✅ Confirm all expected products are included
Red flags:
- 🚩 Products from wrong categories
- 🚩 Count much higher/lower than expected
- 🚩 Discontinued products in the list (if you only wanted active)
- 🚩 Products you don't recognize
Do I Need to Adjust Filters?
If you see issues:
| Issue | Solution |
|---|---|
| Too many products | Add more restrictive filters |
| Too few products | Remove some filters |
| Wrong products | Change filter criteria |
| Missing products | Check if they match ALL filters (AND logic) |
Adjustment workflow:
Is My Action Correct?
Double-check:
- ✅ Selected the right operation (Add/Update/Remove)
- ✅ Filled correct field values (URL, title, position)
- ✅ Position value is appropriate
- ✅ "Registered Only" status is as intended
Extra verification required! Make absolutely sure you want to delete videos from these products. This operation cannot be undone.
🚀 Step 3: Execute the Operation
Once you've verified the preview, the "Execute Bulk Operation" button becomes active.
Execution Process
Steps:
- Click "Execute Bulk Operation"
- A confirmation dialog appears
- Confirm or cancel the operation
- Processing begins with a loading indicator
- Success or error message displays
Confirmation Dialogs
The system shows different confirmations based on the action:
Standard Operations (Add/Update)
Are you sure you want to execute this bulk operation on 12 products?
Options:
- OK → Proceed with the operation
- Cancel → Abort and return to form
What to consider:
- Review the product count one more time
- Ensure you're in the correct shop context
- Verify your action settings are correct
⚠️ Remove Operation - Extra Warning
WARNING: You are about to remove videos from 12 products.
This cannot be undone. Are you sure?
This is your final opportunity to cancel. Once confirmed, videos will be permanently deleted with no recovery option.
Before confirming:
- ✅ Triple-check the product count
- ✅ Review the preview list one more time
- ✅ Consider if you need to backup product data
- ✅ Ensure you're ready for permanent deletion
During Execution
Loading indicator appears:
⟳ Processing...
What's happening:
- The system processes products sequentially
- For large operations (100+ products), this may take several seconds
- Do not close the browser window during execution
- The page automatically updates when complete
Closing the browser or navigating away during execution will interrupt the operation. Affected products may be partially updated.
✅ Step 4: Operation Results
After execution completes, you'll see feedback messages:
Success Messages
✅ Add Operation Success
✓ Successfully added video to 12 products
What this means:
- The video was added to all 12 filtered products
- Videos are now visible (unless set to registered-only)
- Position was applied as specified
- You can verify on individual products
✅ Update Operation Success
✓ Videos updated successfully
What this means:
- All videos on filtered products were updated
- Changes applied to all specified fields
- Empty fields remained unchanged
- Position reordering completed
✅ Remove Operation Success
✓ Successfully removed 24 videos
What this means:
- 24 total videos were deleted (not 24 products!)
- Remaining videos were reordered
- Position gaps eliminated
- Changes are permanent
The success message shows the total number of videos removed, not the number of products affected. One product might have had multiple videos.
Error Messages
If something goes wrong, you'll see specific error messages:
| Error Message | Cause | Solution |
|---|---|---|
Video URL is required for add operation | Add action without URL | Fill the Video URL field |
No update fields specified | Update action with no fields | Fill at least one update field |
An error occurred. Please try again | General/technical error | Refresh page and retry |
No products match the selected filters | Invalid filter combination | Adjust your filters |
What to do:
- Read the error message carefully
- Fix the issue mentioned
- Try the operation again
- See Troubleshooting Guide if errors persist
🔍 After Execution - Verification
Verify the Changes
Always verify changes were applied correctly:
For Add Operations
Verification checklist:
- ✅ Open a few affected products
- ✅ Check that videos were added
- ✅ Verify position is correct
- ✅ Confirm video plays properly
- ✅ Check on frontend if needed
Where to check:
- Back office: Catalog → Products → Edit Product → Videos tab
- Frontend: Product page on your store
For Update Operations
Verification checklist:
- ✅ Check that updates were applied
- ✅ Verify new positions/titles/restrictions
- ✅ Test on a few sample products
- ✅ Confirm changes on frontend
What to verify:
- Video titles changed (if updated)
- Positions reordered (if updated)
- Access restrictions applied (if updated)
For Remove Operations
Verification checklist:
- ✅ Confirm videos are gone
- ✅ Check that remaining videos (if any) are properly reordered
- ✅ Verify on a few products
- ✅ Check frontend to ensure videos don't display
Safety check:
- Videos completely removed from database
- No broken references on product pages
- Remaining videos display correctly
Additional Changes Needed?
If you need to make more changes:
Multiple operations are safe - Each operation is independent and can be applied sequentially.
Example sequence:
- Add videos to products without videos
- Update positions on all products
- Remove old videos from specific category
💡 Best Practices
Before Preview
- ✅ Set up all filters carefully
- ✅ Select the correct action
- ✅ Fill all required fields
- ✅ Double-check your settings
During Preview
- ✅ Actually review the product list (don't just glance!)
- ✅ Verify the count makes sense
- ✅ Check for unexpected products
- ✅ Adjust filters if needed
Before Execute
- ✅ Confirm filters one more time
- ✅ Verify action settings
- ✅ For Remove operations, be absolutely certain
- ✅ Consider testing on a small set first
After Execute
- ✅ Verify changes on sample products
- ✅ Keep the success message for your records
- ✅ Test affected products on frontend if needed
- ✅ Document what operation you performed
⚠️ Safety Tips
Test with 2-3 products first before scaling up. This helps you understand the workflow without risk.
Consider exporting product data first as a backup reference. While you can't restore videos, you'll have a record of what was removed.
Start with a category or manufacturer, verify results, then expand. Build confidence with smaller operations.
🎓 Next Steps
Now that you understand the execution workflow, explore real-world examples:
📖 Common Use Cases
Follow step-by-step real-world examples of mass video operations
You now know how to safely preview and execute bulk operations. Practice with small sets first, then scale up as you gain confidence.
Last updated: 2025-12-13