Wash automatically handles images and files embedded in your WordPress content, uploading them to Shopify's CDN and updating all URLs in your content.
How It Works
Automatic Image Detection
When syncing a post, Wash:
- Scans the content for images
- Downloads images from WordPress
- Optimizes images (if enabled)
- Uploads to Shopify's Files CDN
- Replaces URLs in the content
Image Sources Detected
- Featured images
- Images in post content
- Images in galleries
- Background images in blocks
- Images in ACF fields (Business+ plans)
Image Optimization
Automatic Optimization
Wash can optimize images before upload:
- Resize large images — Max width/height configurable
- Compress quality — Reduce file size while maintaining quality
- Convert to WebP — Modern format with better compression
Configuration
- Go to Wash → Settings → Images
- Enable Optimize Images
- Set maximum dimensions
- Choose quality level (1-100)
- Enable/disable WebP conversion
Optimization Settings
| Setting | Default | Recommended |
|---|---|---|
| Max Width | 2000px | 1600-2000px |
| Max Height | 2000px | 1600-2000px |
| Quality | 85 | 80-90 |
| WebP Conversion | Off | On (with fallback) |
Shopify Files CDN
Where Images Are Stored
Images are uploaded to Shopify's Files section:
- Go to Content → Files in Shopify admin
- Wash images are prefixed with
wash- - Original filename is preserved when possible
CDN Benefits
- Global edge caching
- Automatic format negotiation
- Responsive image transforms
- High availability
URL Replacement
Automatic URL Updates
After upload, Wash updates all references:
srcattributessrcsetattributeshreflinks to images- Background URLs in inline styles
Example
Before sync:
<img src="https://mywordpress.com/wp-content/uploads/2024/01/hero.webp">After sync:
<img src="https://cdn.shopify.com/s/files/1/0123/wash-hero.webp">Featured Images
Automatic Featured Image Sync
The WordPress featured image becomes the Shopify article image:
- Uploaded to Shopify Files
- Set as article featured image
- Available via
article.imagein Liquid
Disabling Featured Image Sync
If you don't want featured images synced:
- Go to blog mapping settings
- Disable Sync Featured Image
File Types Supported
Images
- JPEG / JPG
- PNG
- GIF (including animated)
- WebP
- SVG (passed through, no optimization)
Documents (Links Only)
Non-image files are linked but not hosted:
- PDF links remain pointing to WordPress
- Or upload manually to Shopify Files
Storage and Limits
Shopify File Limits
- Individual file: 20 MB max
- Total storage: Varies by plan (typically unlimited for files)
Wash Processing
- Images over 20 MB are automatically compressed
- Very large files may fail — optimize in WordPress first
Troubleshooting
Images Not Appearing
- Check if the WordPress image URL is accessible
- Verify the image isn't blocked by authentication
- Look in Shopify Files to confirm upload
Wrong Image Displayed
- Clear Shopify CDN cache (wait a few minutes)
- Re-sync the article
- Check for duplicate filenames
Large Images Failing
- Enable optimization with lower max dimensions
- Compress images before uploading to WordPress
- Check Wash logs for specific errors
Best Practices
- Optimize at source — Use appropriate sizes in WordPress
- Use descriptive filenames — Helps with organization
- Add alt text — Synced for accessibility and SEO
- Avoid huge images — 2000px is usually enough