Related reading: ShortPixel for 5 to 50 Websites Pricing: What Small Teams Actually Need to Know and ShortPixel Review for Client Workflows: What Small Teams Managing Multiple Sites Need to K round out the picture.
ShortPixel lets you compress and convert images across every site in your portfolio from one account. Follow the practices in this tutorial and you will have consistent WebP delivery, correct compression settings per site type, and a reliable bulk-processing workflow — without burning through your monthly credits or creating support tickets for your clients.
What This Tutorial Covers
This guide is written for small teams handling between five and fifty client or owned websites. It assumes you are already spending time on image optimization manually — or avoiding it entirely — and want a repeatable system that works whether your sites run on WordPress, Craft CMS, a static generator, or a custom stack. By the end, you will have a configured ShortPixel account, the right compression profile applied per site type, and a process your whole team can follow without guesswork.
Requirements Before You Start
| Requirement | Have It? | Where to Get It |
|---|---|---|
| ShortPixel account with a plan that covers your monthly image volume | Yes / No | Create or review your ShortPixel account |
| Admin or FTP access to each site you manage | Yes / No | Request from site owner or your hosting provider |
| A list of all sites and their primary content types (photos, product images, illustrations, etc.) | Yes / No | Create a simple spreadsheet before proceeding |
| ShortPixel API key (found in your account dashboard) | Yes / No | Log in to ShortPixel and copy from the API key section |
| A staging or test site for at least one CMS where you can verify output before rolling out | Yes / No | Spin up a local copy or use your host's staging tool |
| Team agreement on acceptable quality thresholds (lossy vs. lossless vs. glossy) | Yes / No | Decide internally before configuring any site |
Expected Outcome When This Section Is Complete
After working through this opening checklist you will have:
- An active ShortPixel account matched to your portfolio size
- Your API key saved somewhere your whole team can reference securely
- A site inventory spreadsheet that maps each domain to its content type and agreed compression profile
- At least one staging environment ready for test compressions in the next section
You will not yet have touched any live site images. That is intentional. Teams that skip the inventory step frequently over-compress photography-heavy sites or under-compress sites where page speed is the primary concern. Getting the preparation right here prevents those mistakes at scale.
Check ShortPixel plans for your team sizePricing Pending — confirm current plan limits and credit volumes directly with ShortPixel before purchasing. Promotional discounts and bonus limits may be time-limited and may not be available at renewal.
Steps 1 to 3: Setting Up ShortPixel the Right Way for Multi-Site Teams
Getting ShortPixel configured correctly from day one saves you from re-processing thousands of images later. These first three steps cover account structure, plugin or API setup, and compression mode selection — the decisions that shape how well the tool fits across a portfolio of five to fifty sites.
Step 1: Choose the Right Account and API Structure Before Touching Any Site
ShortPixel sells image credits rather than per-seat licenses, which makes it unusually team-friendly. Before you install anything, decide whether your team will share a single API key across all client sites or use separate keys per client. Shared keys are simpler to manage and let you pool credits efficiently. Separate keys make billing transparent to individual clients and help you track usage per project.
For most teams handling five to twenty sites, a single account with one API key works fine. Once you cross twenty sites or start billing clients individually, separate sub-accounts or dedicated keys reduce confusion during reporting and renewals.
Log into your ShortPixel dashboard, copy your API key, and keep it in your team's shared credential manager — not in a personal email thread.
Check ShortPixel Plans and API OptionsStep 2: Install and Connect ShortPixel on Each Site
ShortPixel offers a WordPress plugin, a cloud API for non-WordPress stacks, and a CLI tool for custom pipelines. If your portfolio mixes WordPress with other CMS platforms — a common reality for small agencies — plan for both paths.
For WordPress installations, install the ShortPixel Image Optimizer plugin, paste your API key, and save. The plugin immediately validates the key against the ShortPixel servers, so you know within seconds whether credentials are correct. For non-WordPress sites, integrate via the REST API or use ShortPixel's command-line tool to point at a local image folder.
Verification matters here. After connecting, upload a single test image manually and confirm it appears in the ShortPixel plugin's optimization log or API response with a reported file-size reduction. If the log shows an error rather than a compression percentage, the connection has not completed — recheck the API key and server outbound HTTP access before moving to bulk processing.
Step 3: Select the Compression Mode That Matches Each Site's Content Type
ShortPixel offers three compression modes: Lossy, Glossy, and Lossless. Picking the wrong one is the single most common mistake teams make when learning how to use ShortPixel best practices across varied client sites.
Lossy delivers the largest file-size reductions — typically 60 to 80 percent on photographic images — and suits blogs, service pages, and most marketing sites where pixel-perfect fidelity is not a client requirement. Glossy sits between Lossy and Lossless, reducing files noticeably while keeping visual quality high enough for portfolio and photography sites. Lossless is for images where no pixel data can change: product images with legally required accurate colour reproduction, medical photography, or any asset that will be re-edited downstream.
Set the compression mode before running bulk optimization. Changing it after processing requires re-optimizing your entire media library, consuming additional credits. Document your mode choice per site in your project notes so any team member picking up the account later knows why Glossy was selected over Lossy for a given client.
Steps 4 to 6: Compression Settings, Multi-Site Rollout, and Ongoing Maintenance
Once your API key is connected and your first site is processing images, the real decisions begin. Steps 4 through 6 cover the choices that separate a quick setup from a genuinely optimized workflow — particularly when you are responsible for anywhere from five to fifty sites at once. Getting these right is the core of how to use ShortPixel best practices at scale.
Step 4: Choose the Right Compression Level for Each Site
ShortPixel offers three compression modes: Lossy, Glossy, and Lossless. Most teams default to Lossy without thinking about it, but that is not always the right call. Here is how to match the mode to the site type:
- Lossy works well for content-heavy blogs, news sites, and landing pages where fast load times matter more than pixel-perfect fidelity.
- Glossy is the practical middle ground for client sites with product photography or professional service imagery where quality expectations are higher.
- Lossless is appropriate for sites carrying logo files, technical diagrams, or medical and legal imagery where even minor visual degradation is unacceptable.
When managing multiple client sites, document the compression choice in your site notes so you are not second-guessing it six months later during a site audit.
Review ShortPixel's compression optionsStep 5: Roll Out Across Multiple Sites Without Burning Credits
If you manage ten or more sites, an unplanned bulk compression run can exhaust your monthly credits in hours. Before you trigger bulk optimization on a new site, run a quick audit using ShortPixel's image count estimate inside the plugin or API dashboard. This tells you how many images are queued before a single credit is spent.
A sensible rollout sequence for multi-site teams looks like this: start with your highest-traffic sites first, limit the initial bulk run to images uploaded in the last 12 months, and schedule remaining historical images over subsequent days. ShortPixel's bulk optimization tool lets you pause and resume at any point, so there is no reason to process everything in one uncontrolled run.
Step 6: Set Up Automatic Optimization and Schedule Periodic Reviews
Automatic optimization — where new uploads are compressed immediately on save — should be enabled on every active site you manage. This is the setting most teams enable once and forget, which is largely fine, but it does require occasional review. Check three things every quarter: that auto-optimization is still active after plugin or CMS updates, that your backup folder has not grown to an unmanageable size, and that any newly added image libraries (such as a newly installed page builder or gallery plugin) are being captured by ShortPixel's scan.
For teams running CMS platforms beyond WordPress — such as those using Craft CMS, Statamic, or headless setups — ShortPixel's API integration handles automatic optimization independently of any plugin layer, making quarterly checks even simpler to standardize across unlike platforms.
Explore ShortPixel's multi-site and API optionsSection 4: Troubleshooting ShortPixel — Common Failures, Fixes, and Validation Checks
Even teams with solid workflows hit snags when scaling image optimization across 5 to 50 websites. Most ShortPixel issues fall into a short list of repeatable patterns. Knowing what to check first saves hours of back-and-forth across client accounts.
Images Not Compressing After Upload
The most frequent complaint is images sitting unprocessed in the queue. Before anything else, verify your API key is correctly entered in the plugin or API settings — a single stray space will cause silent failures. Next, confirm your monthly quota has not been exhausted. ShortPixel counts credits per image file, not per page, so sites with large galleries can drain an allocation faster than expected. Check the ShortPixel dashboard under your account to see remaining credits.
If credentials and quota look fine, check whether the image directory is writable. Shared hosting environments sometimes restrict write permissions after server updates. A quick permissions audit on /wp-content/uploads (or your CMS equivalent) usually resolves this.
WebP or AVIF Versions Not Serving
ShortPixel generates next-generation formats, but serving them requires correct server configuration. If visitors are still receiving JPEGs, the most common cause is missing rewrite rules. For Apache servers, the plugin can add the necessary .htaccess rules automatically, but only if the file is writable. On Nginx servers, you must add the rewrite logic manually to your server block — ShortPixel's documentation includes the exact snippet. Confirm the rules are in place by checking response headers in your browser's developer tools; a correctly served WebP will show Content-Type: image/webp.
Optimization Results Look Inconsistent Across Sites
Teams managing multiple sites often notice that identical images compress differently depending on the site. This usually traces back to different compression mode settings per installation — one site may be set to Lossy while another uses Lossless. Standardize your compression mode across all accounts in the ShortPixel dashboard, or document the intentional exceptions for sites with strict image fidelity requirements (photography portfolios, print-prep workflows).
Bulk Re-optimization Failing Midway
Bulk jobs can time out on shared or low-resource hosting. If a bulk run stops partway through, do not restart from scratch — ShortPixel tracks which images have already been processed and will resume from where it left off. Simply re-trigger the bulk optimization. If timeouts persist, reduce the number of images processed per batch in the plugin settings. Dropping from 10 to 3 per batch resolves the majority of timeout issues on constrained environments.
Validation Checks Worth Running Regularly
Build a brief monthly audit into your team's workflow. Check the ShortPixel dashboard for quota usage trends, confirm WebP delivery by spot-checking response headers on two or three representative pages per site, and verify that newly added image directories (such as a CDN subdirectory or a custom theme folder) are included in the optimization scope. Skipping these checks is one of the most common reasons teams using ShortPixel across many sites gradually accumulate unoptimized images without realizing it.
Running these checks consistently across your portfolio is the practical foundation of how to use ShortPixel best practices at scale.
Check ShortPixel Plans and Quota OptionsDid It Work? Check These Before You Go Live
Before you push any site live or hand off a batch of optimized images to a client, run through these binary checks. Each one has a clear pass or fail — no judgment calls required at this stage.
Binary Objective Checks
- Open the ShortPixel dashboard and confirm the queue shows zero pending items for the domain you just processed.
- Pull up one original file size and one compressed file size from the log. The compressed version should be measurably smaller — if sizes match, lossy or glossy compression may not have been applied.
- Visit a page with a recently compressed image and inspect the served file extension in your browser DevTools Network tab. WebP or AVIF should appear if your server supports it and ShortPixel's CDN delivery is active.
- Check that your original backups folder still exists and contains unmodified files — ShortPixel stores these automatically when the backup option is on, but confirm the path is intact.
- Run a single URL through Google PageSpeed Insights. The "Serve images in next-gen formats" warning should be gone or reduced for images ShortPixel has already processed.
- Confirm your API credit balance in the ShortPixel account panel. A zero or negative balance means future uploads will queue but not compress.
Ready to Go Live? Subjective Readiness Check
Once the binary checks pass, these questions require your team's judgment before flipping the switch across all 5 to 50 sites.
- Are the compressed images visually acceptable at the sizes they actually render on screen — not just at thumbnail scale in the dashboard?
- Has someone on the team reviewed images that contain fine text, logos, or product detail shots under the compression level you selected?
- Do you have a rollback plan — a confirmed backup location and a test restore — so you can undo a batch without contacting support under pressure?
- If you are using ShortPixel's CDN delivery, have you tested page load on a mobile device over a throttled connection, not just on a fast office network?
Frequently Asked Questions
How do I know ShortPixel actually compressed an image and did not just re-save it?
Compare the file size listed in the ShortPixel log against the original backup. A genuine compression result under lossy mode typically reduces file size by 20 to 80 percent depending on the source image. If the numbers are nearly identical, check whether the image was already heavily compressed before upload.
What happens if my API credits run out mid-batch?
ShortPixel queues the remaining files but does not process them until you add credits. Nothing is deleted or corrupted — you can top up and resume without restarting the batch.
Can I re-compress images if I chose the wrong compression level the first time?
Yes. ShortPixel stores the original backup and allows you to re-process images at a different compression level. This does consume additional API credits, so it is worth getting the level right on a small test batch first.
Does ShortPixel work on sites that are not built on WordPress?
ShortPixel offers API access and integrations beyond WordPress, including plugins for other CMS platforms and a standalone web interface for manual uploads. Small teams running mixed CMS environments can use the API to process images regardless of the underlying platform.