Rollback & Tracking

Track imports and rollback changes when needed

Overview

PrimeLink automatically tracks all items created or updated during imports. This tracking system allows you to rollback (undo) an entire import, restoring your store to its previous state.

Rollback is useful when an import doesn't produce the expected results, when you need to test different import configurations, or when you need to revert changes made by mistake.

How Tracking Works

Automatic Tracking

PrimeLink automatically tracks:

  • Created Items: All new items created during import (products, orders, customers, etc.)
  • Updated Items: All existing items updated during import with backup of previous data
  • Import Metadata: Import ID and timestamp stored on each item

What Gets Tracked

For each import, PrimeLink tracks:

  • Item IDs: All created and updated item IDs
  • Item Types: Product, Order, Customer, Coupon, Category, Tag, etc.
  • Backup Data: Complete backup of updated items before changes
  • Import Timestamp: When the import was performed

Tracking Storage

Tracking data is stored:

  • In WordPress options (import-specific tracking)
  • As post meta on each item (import ID and timestamp)
  • Backup data stored in tracking records

Viewing Import Tracking

Manage Imports Page

View tracking information for each import:

  1. Go to PrimeLink → Imports → Manage Imports
  2. Find your import in the list
  3. View tracking summary (created/updated counts)
  4. Click "Rollback" button to rollback the import

Rollback Summary

Before rolling back, you can view a summary:

  • Total items created
  • Total items updated
  • Breakdown by item type (products, orders, etc.)
  • Confirmation of what will be rolled back

Rollback Process

What Rollback Does

Rollback performs two main actions:

1. Delete Created Items

  • Permanently deletes all items created during the import
  • Products, Orders, Customers, Coupons, etc.
  • Cannot be undone - items are permanently removed

2. Restore Updated Items

  • Restores updated items to their previous state
  • Uses backup data stored during import
  • All changes made by the import are reverted

Rollback Options

When rolling back, you can choose:

  • Delete Created Items: Remove all items created during import
  • Restore Updated Items: Restore updated items to previous state
  • Both: Perform both actions (default)

Performing a Rollback

Step-by-Step Process

  1. Navigate to Manage Imports: Go to PrimeLink → Imports → Manage Imports
  2. Find Your Import: Locate the import you want to rollback
  3. View Summary: Check the tracking summary (created/updated counts)
  4. Click Rollback: Click the "Rollback" button or action
  5. Confirm Options: Choose what to rollback (created items, updated items, or both)
  6. Confirm Action: Confirm the rollback (this cannot be undone)
  7. Wait for Completion: Rollback processes all tracked items
  8. Review Results: Check the results summary
⚠️ Warning: Rollback cannot be undone. Once you rollback an import, all created items are permanently deleted and updated items are restored. Make sure you want to proceed before confirming.

Rollback Results

Result Summary

After rollback completes, you'll see a summary:

  • Deleted: Number of created items deleted
  • Restored: Number of updated items restored
  • Errors: Number of errors encountered (if any)

Error Handling

If errors occur during rollback:

  • Errors are logged and reported
  • Successful operations still complete
  • Check error logs for details
  • You may need to manually clean up remaining items

Supported Item Types

Rollback Support

Rollback supports all WooCommerce entity types:

  • Products: Simple, Variable, Grouped, External
  • Orders: All order types
  • Customers: Customer accounts
  • Coupons: Discount coupons
  • Categories: Product categories
  • Tags: Product tags
  • Attributes: Product attributes
  • Variations: Product variations
  • Reviews: Product reviews

Best Practices

  • Test imports first: Use Dry Run mode before running real imports
  • Review tracking: Check tracking summary before rolling back
  • Backup your store: Always backup before large imports or rollbacks
  • Verify results: Check import results before deciding to rollback
  • Rollback promptly: Rollback soon after import if needed (before other changes)
  • Check dependencies: Be aware of dependencies (e.g., orders linked to products)
  • Document changes: Keep notes of what was imported for reference

Limitations and Considerations

What Rollback Cannot Do

  • Cannot undo manual changes: Only reverts changes made by the tracked import
  • Cannot restore deleted items: If items were manually deleted after import, they cannot be restored
  • Dependencies: Related items (e.g., orders with imported products) may be affected
  • Time-sensitive: Best used soon after import, before other changes are made

Dependencies

Be aware of dependencies when rolling back:

  • Orders linked to imported products may be affected
  • Products linked to imported categories/tags will lose those associations
  • Variations linked to imported attributes will be affected
  • Reviews linked to imported products will be orphaned

Tracking Cleanup

Automatic Cleanup

Tracking data is automatically cleaned up:

  • After successful rollback
  • When import is deleted
  • Tracking data is removed from items

Manual Cleanup

If needed, you can manually clean up tracking:

  • Delete old imports from Manage Imports
  • Tracking data is automatically removed
  • Item meta (import ID, timestamp) can remain but doesn't affect functionality

Common Use Cases

Testing Imports

  • Run a test import with sample data
  • Review results and verify data
  • Rollback if results are incorrect
  • Adjust import settings and try again

Correcting Mistakes

  • Import with incorrect mapping or data
  • Discover errors after import completes
  • Rollback to restore previous state
  • Fix data or mapping and re-import

Comparing Configurations

  • Import with one configuration
  • Review results
  • Rollback and try different configuration
  • Compare results to find best approach

Common Issues and Solutions

Rollback Button Not Available

  • Check if import has tracking data (created or updated items)
  • Verify import completed successfully
  • Check if tracking was enabled during import
  • Some imports may not have items to rollback

Items Not Rolled Back

  • Check if items were manually deleted after import
  • Verify items still exist in your store
  • Check error logs for specific issues
  • Some items may have dependencies preventing deletion

Partial Rollback

  • Check rollback results summary for errors
  • Review error logs for specific issues
  • Manually clean up remaining items if needed
  • Some items may require manual intervention

Next Steps

🧪 Dry Run & Test Mode

Learn how to test imports before running them

Learn More →
⚡ Performance & Optimization

Optimize import performance and settings

Learn More →
📥 Creating Imports

Complete guide to creating imports

Learn More →