Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared Managed Cloud India
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Best lists Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Plugin how-tos · Guide

How Do ShortPixel Settings Work in WordPress?

Short answer

ShortPixel settings live under Settings > ShortPixel in your WordPress dashboard. You enter an API key, pick a compression type, choose which thumbnails and formats to process, and set backups, resizing, and WebP or AVIF delivery. After you save, run bulk optimization from Media > Bulk ShortPixel to process images already in your library.

Key takeaways

  • ShortPixel settings live under Settings > ShortPixel, with tabs for Image Optimization, Exclusions, Processing, WebP/AVIF and CDN, Integrations, and Tools.
  • The free plan includes 100 credits per month as of November 2026, and a credit is used only when a file shrinks by at least 5%.
  • Lossy gives the smallest files, Glossy keeps more detail for photos and product shots, and Lossless keeps every pixel.
  • Backups are stored locally by default, so you can restore an original image one by one or in bulk.
  • Creating a WebP or AVIF file is not the same as serving it, so you must also pick a delivery method.
  • Check your work in the Media Library and in Chrome DevTools, where the image type should read webp or avif.

Where are ShortPixel settings in WordPress?

You will find ShortPixel settings under Settings > ShortPixel in your WordPress dashboard after you install and activate the plugin.

The settings screen is split into tabs, and each tab covers one job. WordPress.org lists the tabs as Image Optimization, Exclusions, Processing, WebP/AVIF and CDN, Integrations, Tools, and Help Center, and the same list appears in the plugin screenshots on the ShortPixel Image Optimizer plugin page.

TabWhat it controls
Image OptimizationCompression, thumbnails, resizing, backups, EXIF
ExclusionsImages, paths, sizes, and thumbnails to skip
ProcessingAuto-optimization on upload and background jobs
WebP/AVIF and CDNNext-gen formats, delivery method, and CDN
IntegrationsCloudflare and other connected services
ToolsRestore, re-optimize, and remove data

Start on the Image Optimization tab, then move through the tabs in order. That order matches how the plugin works: compress first, decide what to skip, decide when it runs, then decide how new formats reach visitors.

What do you need before you change a setting?

You need an installed plugin, a ShortPixel API key, and a site backup before you change any setting.

Install ShortPixel Image Optimizer from Plugins > Add New, then activate it. WordPress.org says you sign up with your email at shortpixel.com/wp-apikey and receive your API key in a confirmation email, then paste it into Settings > ShortPixel to activate the plugin.

One API key can be used on as many sites as you wish while credits last, according to the ShortPixel Image Optimizer plugin page. That helps if you manage several sites, but all of them draw from the same credit balance.

Take a full site backup first, even though ShortPixel keeps its own image backups. A site backup covers your database and files if anything else goes wrong, and our guide to backing up WordPress walks through the options.

Allow about 10 minutes for install, key entry, and a first look at the tabs.

How do you choose the compression setting?

Pick Lossy for most sites, Glossy for photos and product shots where detail matters, and Lossless only when every pixel must stay the same.

The compression type sits on the Image Optimization tab and applies to all images. WordPress.org describes the three choices this way: Lossy gives maximum file size reductions, Glossy gives a strong balance between quality and compression, and Lossless gives pixel-perfect image quality.

Glossy is a high-quality lossy option built for photographers and sites with high-quality product pictures, according to the same plugin page. If you sell products or show portfolio work, start with Glossy and look at a few images at full size before you run a bulk job.

A separate guide in this batch compares the three types in detail, so this guide stays with the setting itself. The key point is that you can change the type later and re-optimize, as long as your originals are backed up.

How do you set up WebP and AVIF delivery?

Turn on “Create WebP Images” and “Create AVIF Images” on the WebP/AVIF and CDN tab, then pick one delivery method.

Creating the files is only half the job. ShortPixel's own blog explains that creating WebP files is not the same as serving them, and most problems hide in the delivery layer, not the conversion step. The three delivery methods are the picture tag, .htaccess rules, and the ShortPixel CDN.

The picture-tag method rewrites each img tag into a picture tag that holds the WebP or AVIF address and the original address. It runs on any server, which makes it the safe fallback when your server setup is unclear.

The .htaccess method leaves your HTML alone and swaps the file at server level for browsers that support the new format. ShortPixel notes that this method only works on Apache and LiteSpeed, because Nginx never reads .htaccess files.

If your host runs Nginx, use the picture-tag method or the CDN instead.

The CDN method serves images from ShortPixel's global CDN, which WordPress.org says also delivers CSS, JavaScript, and font files from locations closer to visitors.

Google's WebP documentation gives a reason to bother: lossy WebP images are 25-34% smaller than comparable JPEGs at equal quality, and lossless WebP images are 26% smaller than PNGs (Google for Developers).

How do you control thumbnails, resizing, and PNG conversion?

Use the Image Optimization tab to choose which thumbnails to process, set a maximum size for large uploads, and turn on PNG to JPG conversion only for suitable images.

WordPress creates several thumbnail sizes for each upload, and visitors load those sizes on archive pages and in posts.

ShortPixel can optimize thumbnails and featured images, and you can exclude single thumbnail sizes you do not need. That matters for credits, because WordPress.org says a typical image has 3 to 5 thumbnails, and each optimized thumbnail uses a credit.

Resizing caps the largest dimension of new uploads. The plugin offers two automatic resizing options for large images, and ShortPixel's own guides suggest a cap of 1920 to 2560 pixels wide for most sites.

A smaller cap saves more space, but it also limits how large an image can ever appear.

PNG to JPG conversion helps when a PNG is really a photo or a flat graphic with no transparency. Turn it on only if your PNGs do not need a clear background, because JPG has no transparency.

ShortPixel also lists CMYK to RGB conversion and progressive JPEG output among its features on the plugin page.

How do backups and restore work in ShortPixel?

Turn on “Image backup” and ShortPixel saves each original locally before it replaces the file, so you can restore it later.

Backups are stored in a folder that is usually /wp-content/uploads/ShortpixelBackups, according to ShortPixel's knowledge base. The plugin page adds that originals are backed up locally by default and can be restored with a single click, one by one or in bulk.

Smart Backups saves disk space by backing up only the main image. When you restore, thumbnails are rebuilt from your current settings. You can also set rules to delete old backups after a chosen period, which keeps the backup folder from growing without limit.

You need the original if you want to switch a file from Lossy to Lossless, or the other way around. WordPress.org states this plainly: the original image is needed if you want to restore an image or convert it between lossy, glossy, and lossless.

Never turn backups off before a bulk job.

How do exclusions and custom folders work?

Use the Exclusions tab to skip images by filename, path, size, or pattern, and use the Processing or Advanced area to add folders outside the Media Library.

Exclusions protect images that must stay untouched. WordPress.org lists advanced exclusion options based on filename, path, size, or complex regex, plus an option to skip very small images or large images that photographers need to keep in full form.

You can also exclude a single thumbnail size. That is useful when a theme size is used for a logo or a small icon, where compression would not save much and could soften sharp edges.

ShortPixel can optimize images that are not in the Media Library. WordPress.org says you add the folders where those images live in the Advanced section of the settings, and the plugin then processes them.

That covers theme images and gallery folders added by FTP, which a normal Media Library bulk run would miss.

How do you run bulk optimization and check it worked?

Go to Media > Bulk ShortPixel, review the counts, start the job, and then check the Media Library and your browser tools.

Bulk optimization processes the images already in your library. WordPress.org says you can bulk-optimize all images in the Media Library with a single click, and filter by date to control which images are processed and when.

Background mode lets images be optimized without keeping a browser tab open. The plugin page also lists recurring cron jobs for background optimization and full WP-CLI support, which helps large libraries. Allow time for a large library: a few hundred images may take minutes, while thousands can take much longer.

Check the result in two places. First, open the Media Library: ShortPixel adds a column showing the compression percentage and a status icon for each image, and a green check means it processed correctly.

Second, open Chrome DevTools, go to the Network tab, filter by images, reload the page, and look at the Type column. ShortPixel's HEIC guide says the type should read webp or avif, not jpeg, when delivery works. If you want faster pages overall, read our guide to speeding up WordPress.

How do credits work, and when do they run out?

ShortPixel counts one credit per image or thumbnail it shrinks by at least 5%, and the free plan gives you 100 credits per month as of November 2026.

That 5% rule is good news for small files. WordPress.org says no credit is used for images optimized by less than 5%, and the same rule applies to thumbnails. A file that is already tiny costs you nothing.

The math adds up fast, though. One upload with 5 thumbnails can use 6 credits, and each WebP or AVIF copy costs another credit.

ShortPixel's knowledge base adds a 5% margin rule: if a WebP or AVIF copy is more than 5% larger than the compressed JPG or PNG, the plugin drops it and does not save it.

PlanPrice as of November 2026Credits
Free$0100 credits per month
Unlimited monthly$9.99 per monthUnlimited monthly credits
One-time packsFrom $19.99Credits never expire

Monthly credits expire after 30 days, while one-time credits never expire, according to the plugin page.

When the free monthly quota runs out, optimization pauses until the quota resets or you buy a plan. Check your remaining credits on the settings screen before a big bulk job, and compare cache settings in our LiteSpeed Cache settings guide if you also run a cache plugin.

What else sits in the Integrations and Tools tabs?

Integrations holds the Cloudflare connection, and Tools holds restore, re-optimize, and cleanup actions.

The Cloudflare integration syncs ShortPixel updates with the Cloudflare cache through a Cloudflare token. That stops visitors from seeing a stale cached copy after an image is optimized or restored. You need your Cloudflare token and zone ID to set it up.

Tools is where you fix things after the fact. You can restore originals, re-optimize an image after changing a setting, and remove all ShortPixel data if you stop using the plugin. ShortPixel's blog notes a “Remove all ShortPixel Data” tool under Settings > ShortPixel > Tools.

The plugin also lists a 30-day optimization report with image statistics and site performance improvements. Open it once a month to see how much space you saved and whether your credit use matches your upload rate.

If image speed still hurts your scores, our WP Rocket setup guide covers the cache side.

Our INP explainer explains one metric images can affect.

What mistakes should you avoid?

Do not run a bulk job before backups are on, do not turn on every format at once on a large library, and do not pick a delivery method your server cannot run.

The most common mistake is bulk-optimizing a whole library with backups off. Without an original, you cannot restore a file or change its compression type later. Check the backup setting first, run a small batch, and look at the results before you process the rest.

The second mistake is turning on WebP and AVIF, plus thumbnails, on a large library while still on the free plan. Each extra copy costs a credit, so 100 free credits can vanish on a handful of uploads.

Count your thumbnails on the bulk screen first, then decide which formats you really need.

The third mistake is picking .htaccess delivery on Nginx, or turning on picture-tag delivery when a theme or page builder already rewrites image markup.

ShortPixel's WebP guide warns that the picture-tag method can clash with themes and plugins that output images in a way the rewriter cannot handle. If images vanish or stop showing, switch delivery methods and clear your cache before you change anything else.

Frequently asked questions

Do I need an API key to use ShortPixel settings?

Yes. ShortPixel optimizes images in its cloud, so the plugin needs an API key to connect your site to your account. Sign up with your email, copy the key from the confirmation email, and paste it into Settings > ShortPixel. The free plan gives you 100 credits per month as of November 2026.

What happens if I run out of ShortPixel credits during a bulk job?

Optimization pauses until your monthly quota resets or you buy more credits. Images already processed stay optimized, and unprocessed images stay as they were. Check your remaining credits on the settings screen before a large bulk job, and remember that thumbnails and WebP or AVIF copies each use credits.

Can I change the compression type after images are already optimized?

Yes, if your originals are backed up. Change the compression type on the Image Optimization tab, then re-optimize the images you want to change. Without a backup, ShortPixel cannot rebuild the file from the compressed version, so keep the image backup setting turned on.

Why are my WebP files created but not showing in the browser?

Creating a file and serving it are two different steps. Check that a delivery method is picked on the WebP/AVIF and CDN tab, clear your page and browser cache, and confirm your server supports the method. The .htaccess method only works on Apache or LiteSpeed, never on Nginx.

Does ShortPixel work on images outside the Media Library?

Yes. Add the folders in the Advanced section of the settings, and ShortPixel will process images stored there, including theme and gallery images added by FTP. You can also exclude folders, filenames, paths, and sizes you do not want touched.

How large can an image be for ShortPixel to optimize it?

The plugin lists a 100MB file size limit. Files above that limit will not be processed. If you hit the limit, resize the image before upload, or split a very large PDF into smaller files first.

Sources

  1. ShortPixel Image Optimizer – Optimize Images, Convert WebP & AVIF WordPress.org
  2. Why Your WebP Images Aren't Showing in WordPress ShortPixel
  3. HEIC/HEIF on WordPress: An End-to-End Workflow from iPhone Upload to WebP/AVIF ShortPixel
  4. Actions and filters of ShortPixel Image Optimizer ShortPixel Knowledge Base
  5. An image format for the Web Google for Developers
  6. Configure NGINX to transparently serve next-gen format files when supported ShortPixel Knowledge Base

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

WPLegible editors

Researched from the primary sources listed above and checked against our editorial rules. About the site · How we test