Bulk Actions

PromoSync integrates with Shopify’s bulk actions system, allowing you to manage multiple synced products efficiently. This guide covers all available bulk operations.

Accessing Bulk Actions

From Shopify Admin

1. Go to Products in your Shopify admin
2. Select multiple products using checkboxes
3. Click More actions in the toolbar
4. Find PromoSync actions in the dropdown

From PromoSync App

1. Navigate to PromoSync > Products
2. Select products using checkboxes
3. Click Bulk Actions button
4. Choose an action

Available Bulk Actions

PromoSync provides 5 bulk operations:

Sync Inventory

Update inventory levels for selected products from their suppliers.

When to Use

• After receiving inventory alerts
• When products show incorrect stock
• Before high-traffic periods
• After supplier restocking

How to Sync Inventory

1. Select products to update
2. Click Bulk Actions > Sync Inventory
3. Confirm the action
4. Wait for completion

// Sync result
{
  "action": "sync_inventory",
  "productsProcessed": 25,
  "variantsUpdated": 450,
  "success": 448,
  "failed": 2,
  "duration": "45s"
}

Sync Progress

A progress indicator shows:

• Products processed
• Variants updated
• Errors encountered
• Estimated time remaining

Handling Sync Errors

If variants fail to sync:

{
  "errors": [
    {
      "product": "Basic Tee",
      "variant": "Black/XXL",
      "error": "Variant not found at supplier"
    }
  ]
}

Resolution:

• Variant may be discontinued
• Check variant mapping
• Manually update or remove variant

Update Pricing

Recalculate prices for selected products using your current pricing settings.

When to Use

• After changing pricing strategy
• When markup percentages change
• After supplier price updates
• When switching pricing tiers

How to Update Pricing

1. Select products to reprice
2. Click Bulk Actions > Update Pricing
3. Optionally override settings:
   • Pricing strategy
   • Markup percentage
   • Rounding rules
4. Confirm the action

// Pricing update result
{
  "action": "update_pricing",
  "productsProcessed": 25,
  "variantsUpdated": 450,
  "priceChanges": {
    "increased": 120,
    "decreased": 45,
    "unchanged": 285
  }
}

Preview Pricing Changes

Before applying:

1. Click Preview Changes
2. Review the price change summary
3. See affected products and amounts
4. Proceed or cancel

Compare-At Prices

Update pricing includes compare-at prices:

• Maintains discount appearance
• Updates based on your settings
• Can be excluded from bulk update

Refresh Product Data

Pull the latest product information from suppliers, including descriptions, images, and specifications.

When to Use

• Supplier updated product details
• Images are outdated or missing
• Description changes needed
• New variants available

How to Refresh

1. Select products to refresh
2. Click Bulk Actions > Refresh Product Data
3. Select what to refresh:
   • ☑️ Product description
   • ☑️ Images
   • ☑️ Specifications
   • ☑️ Variants
   • ☐ Pricing (separate action)
4. Confirm the action

Refresh Options

Preserving Customizations

By default, refresh preserves your customizations:

• Custom titles (if modified)
• Custom descriptions (if modified)
• Custom images (if added manually)
• Tags you’ve added

To override customizations, enable Force Refresh.

Remove from Sync

Stop PromoSync from managing selected products. Products remain in your store but won’t receive automatic updates.

When to Use

• Product is discontinued
• You’ve customized it significantly
• Moving to manual management
• Supplier issues

How to Remove from Sync

1. Select products to unlink
2. Click Bulk Actions > Remove from Sync
3. Confirm the action

{
  "action": "remove_from_sync",
  "productsRemoved": 10,
  "message": "Products will no longer receive automatic updates"
}

What Happens

• Product stays in Shopify
• Inventory stops syncing
• Pricing stops updating
• Metafields remain (static)
• Product can be re-synced later

Re-syncing Products

To restore sync for removed products:

1. Find the product in PromoSync
2. Click Reconnect to Supplier
3. Confirm the reconnection

Delete Products

Permanently remove products from your Shopify store.

When to Use

• Products are discontinued
• Cleaning up test imports
• Supplier no longer available
• Complete catalog refresh

How to Delete

1. Select products to delete
2. Click Bulk Actions > Delete Products
3. Warning: This action is permanent
4. Type “DELETE” to confirm
5. Confirm the action

{
  "action": "delete_products",
  "productsDeleted": 15,
  "variantsDeleted": 280,
  "warning": "This action cannot be undone"
}

Recovery

Deleted products cannot be recovered through PromoSync. Options:

• Re-import from supplier
• Restore from Shopify backup (if available)
• Contact Shopify support for recent deletions

Bulk Action Limits

Processing Limits

For larger operations, actions are queued and processed in batches.

Rate Limiting

Bulk actions respect Shopify and supplier rate limits:

• Shopify: 40 requests/second
• Suppliers: Varies by supplier
• PSRESTful: Based on your plan

Actions automatically throttle to stay within limits.

Scheduling Bulk Actions

Scheduled Sync

Set up recurring bulk syncs:

1. Go to Settings > Scheduling
2. Configure automatic inventory sync
3. Set frequency and time window

Manual Queue

Queue actions for later:

{
  "action": "sync_inventory",
  "scheduled": "2024-01-21T06:00:00Z",
  "products": ["gid://shopify/Product/123", "..."]
}

Monitoring Bulk Actions

Action History

View past bulk operations:

1. Navigate to PromoSync > History
2. Filter by Bulk Actions
3. See status, duration, and results

Notifications

Receive notifications for bulk actions:

• In-app notification on completion
• Email summary (optional)
• Webhook events (for developers)

Best Practices

1. Start Small

Test with a few products before running large bulk operations.

2. Schedule During Off-Peak

Run large operations during low-traffic periods.

3. Review Results

Always check the results summary for errors.

4. Backup Important Products

Consider exporting critical products before bulk changes.

5. Use Filters

Narrow your selection to only affected products.

Troubleshooting

Action Times Out

For large operations:

1. Reduce the number of selected products
2. Try during off-peak hours
3. Contact support for assistance

Partial Completion

If an action partially completes:

1. Review the error summary
2. Fix issues with failed products
3. Retry only the failed products

Unexpected Results

If results don’t match expectations:

1. Verify your settings before the action
2. Check for recent setting changes
3. Review the action log for details