Documentation
Everything you need to know about optimizing your Webflow images with Smolpix.
Getting Started
Smolpix helps you optimize images in your Webflow CMS collections, reducing file sizes by up to 92% while maintaining visual quality. Follow these steps to get started:
Create an account
Sign up for a free Smolpix account at smolpix.co/signup
Set up Webflow OAuth
Create a Webflow App and add your Client ID and Secret in Settings
Connect your site
Authorize Smolpix to access your Webflow site via OAuth
Start optimizing
Select a collection, choose images, and click "Optimize"
Webflow Setup
To connect Smolpix to your Webflow site, you need to create a Webflow App with OAuth credentials.
Why do I need my own OAuth credentials?
Webflow requires each user to authorize access to their sites. By using your own App credentials, you have full control over permissions and can revoke access at any time.
Creating a Webflow App
- Go to Webflow Workspace Settings → Apps & Integrations
- Click "Create an App"
- Fill in the app details:
- Name:
Smolpix - Description:
Image optimization for Webflow - Homepage URL:
https://smolpix.co
- Name:
- Set the Redirect URI to:
https://smolpix.co/api/webflow/callback - Enable these scopes:
sites:read- Read site informationsites:write- Publish changescms:read- Read CMS collectionscms:write- Update CMS items
- Copy your Client ID and Client Secret
- Paste them in Smolpix Settings
Image Optimization
Smolpix uses advanced compression algorithms to reduce image file sizes without visible quality loss. Our optimization process:
Smart Format Selection
Automatically chooses the best format (WebP or AVIF) based on image content and browser support.
Lossless Compression
Maintains 99.8% visual quality while achieving up to 92% file size reduction.
Metadata Preservation
Keeps important EXIF data while stripping unnecessary metadata to save space.
Automatic Upload
Optimized images are automatically uploaded back to your Webflow CMS.
Compression Results
| Original Format | Output Format | Typical Savings |
|---|---|---|
| PNG | WebP | 70-85% |
| JPEG | WebP | 25-35% |
| PNG | AVIF | 80-92% |
| JPEG | AVIF | 50-60% |
Supported Formats
Best all-around format with excellent compression and universal browser support. Recommended for most use cases.
Next-generation format with 50% better compression than WebP. Best for high-quality photography and images where every KB matters.
Smolpix accepts: JPEG,PNG,GIF,BMP,TIFF,WebP
CMS Collections
Smolpix integrates directly with your Webflow CMS collections. You can optimize images in:
- Image fields - Single image uploads
- Multi-image fields - Gallery and slider images
- Rich text fields - Images embedded in content
Pro Tip
Use the CMS Explorer to select specific fields to optimize. This gives you fine-grained control over which images get processed.
Batch Processing
Smolpix processes images in parallel for maximum speed. Our batch processing can handle hundreds of images in seconds.
How It Works
- Select the collection items you want to optimize
- Click "Optimize All" to start batch processing
- Watch real-time progress as images are processed
- Optimized images are automatically uploaded to Webflow
- Review the summary with before/after size comparisons
Plans & Limits
| Plan | Sites | Images/mo | Price |
|---|---|---|---|
| Free | 1 | 50 | $0 |
| Starter | 3 | 1,000 | $19/mo |
| ProPopular | 10 | 10,000 | $49/mo |
| Agency | Unlimited | Unlimited | $149/mo |
All paid plans include AVIF conversion, priority support, and optimization history.View full pricing details
Troubleshooting
"No Webflow credentials configured"
You need to add your Webflow App credentials before connecting a site.
Solution: Go to Settings → Add your Client ID and Client Secret from your Webflow App.
"Failed to fetch collections"
This usually means your OAuth token has expired or the site is not accessible.
Solution: Disconnect and reconnect your Webflow site to refresh the OAuth token.
"Image optimization failed"
Some images may fail to optimize due to format issues or size limits.
Solution: Check that the image is under 50MB and in a supported format (JPEG, PNG, GIF, WebP).
"Monthly limit reached"
You've used all your allocated images for this billing period.
Solution: Upgrade your plan or wait until your limit resets at the start of next month.
Frequently Asked Questions
Does optimization affect image quality?
No. Smolpix uses smart compression that maintains 99.8% visual quality. The difference is imperceptible to the human eye, but file sizes are dramatically smaller.
Can I revert optimized images?
Smolpix replaces images in your Webflow CMS. We recommend keeping backups of your original images before bulk optimization. You can always re-upload originals through Webflow.
Do I need to republish my site after optimization?
Yes. After optimization, you need to publish your Webflow site for changes to appear on your live website. CMS items are updated immediately, but require a publish to go live.
What happens to my data?
Images are processed securely and not stored permanently. We only keep optimization logs for 90 days. See our Privacy Policy for details.
Which browsers support WebP and AVIF?
WebP is supported by 97%+ of browsers (Chrome, Firefox, Edge, Safari 14+). AVIF is supported by 90%+ of browsers in 2026 (Chrome, Firefox, Safari 16+). For older browsers, images will still display but without the format benefits.
Still have questions?
Our support team is here to help you get the most out of Smolpix.
Contact Support