Auto-Optimization

Solixync can automatically optimize images when you add new products or upload new images. Set it up once and let it work in the background.

How Auto-Optimization Works

New Product Trigger

When enabled, Solixync automatically processes images whenever you:

• Create a new product in Shopify
• Import products via CSV or app
• Add products through any Shopify integration

Flow:

You add a new product
    ↓
Shopify notifies Solixync (webhook)
    ↓
Solixync fetches product images
    ↓
Images processed with your default platforms
    ↓
Optimized images update your Shopify product

New Image Trigger

When enabled, Solixync processes images when you:

• Add new images to an existing product
• Replace images on a product
• Upload additional product photos

Note: Only new images are processed. Existing images that haven't changed are skipped.

Setting Up Auto-Optimization

During Onboarding

The onboarding wizard (Step 3) lets you enable:

• ☑️ Auto-optimize new products
• ☑️ Auto-optimize new images

In Settings

Anytime after installation:

1. Go to Settings
2. Find the Auto-Optimization section
3. Toggle each option on or off
4. Changes save automatically

Configuration Options

Default Platforms

Choose which platforms auto-optimized images target:

Tip: Select all platforms where you might list products. It's easier to have them ready than to reprocess later.

Update Behavior

How optimized images are applied to Shopify:

Auto-Update on Complete

• Enabled: Images automatically update in Shopify when processing finishes
• Disabled: You'll need to manually approve updates

For auto-optimization, we recommend keeping this enabled so it's fully hands-off.

Best Practices

Start Conservative

If you're unsure, start with:

1. Enable only "new products" trigger
2. Use "files only" update behavior
3. Review results before enabling full automation

Once comfortable, enable "replace" for seamless automation.

Platform Selection

Select all platforms you might use:

• Processing happens once, exports for all selected platforms
• Better to have exports ready than to reprocess
• Extra platform exports don't affect your quota

Monitor Initially

When first enabling auto-optimization:

1. Add a test product
2. Check the Jobs page for processing status
3. Verify the results look correct
4. Adjust settings if needed

What Gets Processed

Included

• All images attached to new products
• New images added to existing products (if enabled)
• Images from any source (upload, CSV import, API)

Excluded

• Existing images that haven't changed
• Draft products (only published products)
• Variant-specific images (main product images only)

Monitoring Auto-Optimization

Jobs Page

Auto-optimized jobs appear in your Jobs list:

• Labeled as "Auto-optimized"
• Shows which product triggered it
• Same status tracking as manual jobs

Dashboard

Recent auto-optimization jobs show on your dashboard in the "Recent Jobs" section.

Notifications

Get notified when auto-optimization:

• Completes successfully
• Encounters errors
• Uses significant quota (approaching limit)

Troubleshooting

Auto-Optimization Not Triggering?

1. Check Settings - Ensure the trigger is enabled
2. Verify Permissions - App needs write_products permission
3. Check Webhooks - Go to Shopify Admin > Settings > Notifications > Webhooks
4. Product Type - Only published products trigger webhooks

Wrong Platforms Being Used?

1. Go to Settings
2. Check your Default Platforms selection
3. Ensure desired platforms are checked

Images Not Updating in Shopify?

1. Check your Update Behavior setting
2. If set to "Files only", images won't update product pages
3. Try changing to "Replace" or "Add"

Using Too Much Quota?

If auto-optimization is using more quota than expected:

1. Review how many products you're adding
2. Consider upgrading to Unlimited plan
3. Or disable auto-optimization and process manually

Disabling Auto-Optimization

To turn off auto-optimization:

1. Go to Settings
2. Toggle off the triggers you want to disable
3. Existing products and jobs are not affected

You can always process products manually even with auto-optimization disabled.

When to Use Manual Processing Instead

Auto-optimization works great for:

• Consistent product photography
• Standard product images
• High-volume stores

Consider manual processing when:

• Images need individual adjustment
• Some products shouldn't be processed
• You want to review before updating Shopify

Next Steps

• Process products manually
• Manage your subscription
• View platform requirements