Home/Answers/Thumbnails
CROP LAB / Thumbnails

Thumbnails Failed? Troubleshooting

When Thumbnails fails, troubleshoot in order: file/format, permission/lock, output settings, another tool.

Updated 2026-10-31About 3 minLocal test
Quick answer

When Thumbnails fails, troubleshoot in order: file/format, permission/lock, output settings, another tool. Thumbnails need a recognizable subject; do not just shrink.

Why it matters

Start with the most common and cheapest causes to narrow it down fast.

Detail disappears at small sizes.

Step by step

  1. Confirm where and how large the image will be displayed.
  2. Drag a box at the target ratio; center the subject and leave safe margins.
  3. Keep selection pixels at or above the display size.
  4. Export PNG/WebP for text/UI, JPEG 85-90% for photos.
  5. Keep the original; use the crop only for publishing.

Common mistakes

  • Cropping too tight and cutting avatars/products.
  • Ignoring safe areas so cover text gets cropped.
  • Cropping low-resolution images then enlarging, causing blur.
  • Overwriting the original and losing re-crop ability.

Checklist

  • Target ratio/size confirmed.
  • Subject intact with safe margins.
  • Selection pixels >= display size.
  • Format/quality meets the platform.
  • Original kept.

Key facts

  • Detail disappears at small sizes.
  • Subject ratio matters more.

FAQ

How do I troubleshoot a failed Thumbnails task?

When Thumbnails fails, troubleshoot in order: file/format, permission/lock, output settings, another tool. Thumbnails need a recognizable subject; do not just shrink.

How long does it take?

Usually 1-3 minutes; for intermittent issues, run 30 seconds and retest elsewhere.

Is data uploaded?

Runs locally and does not upload video/audio; extensions may still read the page.

Source: Web.dev images