BugWP logo BugWP
Back to Community
Home / Community / Plugin → Jetpack

Troubleshooting Jetpack Image and Gallery Display Issues: A Comprehensive Guide

53 threads Sep 10, 2025 Plugin → Jetpack

Content

Many WordPress users rely on Jetpack for its powerful suite of features, including image acceleration via its Content Delivery Network (CDN) and dynamic gallery displays. However, a common theme across support forums involves images not displaying correctly, galleries malfunctioning, or CDN features not working as expected. This guide compiles the most frequent issues and their solutions, based on community reports and resolutions.

Common Jetpack Image and Gallery Problems

Users often encounter a range of issues related to Jetpack's image handling. These can be broadly categorized as follows:

  • Images Not Loading from CDN: The Site Accelerator is active, but images are still served from the local server.
  • Outdated Images in CDN Cache: An updated image on the server does not change on the front-end because the CDN is serving a cached version.
  • Galleries Not Displaying or Functioning: Tiled galleries break, carousels don't scroll, or blocks become unsupported.
  • Images Distorted in Newsletters: Images appear stretched or squashed in Jetpack-subscribed emails.
  • Images Missing on Specific Devices/Browsers: Images fail to load only on certain platforms, like iOS Safari.

Why Do These Issues Happen?

Understanding the root cause is the first step to a solution. These problems typically stem from:

  • Caching: Jetpack's CDN caches images to improve speed. This is great for performance but means changes to an existing image (with the same filename) may not be immediately visible.
  • Plugin or Theme Conflicts: Another plugin or your theme might be modifying image URLs or output, preventing Jetpack from properly handing them off to its CDN or processing galleries.
  • Block Editor vs. Classic Editor: Some features, particularly galleries, can behave differently depending on which editor was used to create them.
  • Email Client Limitations: The HTML and CSS standards supported by email clients (like Gmail or Outlook) are much more limited than web browsers, which can cause responsive images to break.
  • Connection Issues: An unstable connection between your site and Jetpack's servers can prevent features from activating correctly.

Step-by-Step Troubleshooting Guide

1. Verify Jetpack Settings and Connection

First, ensure the relevant features are turned on and Jetpack is connected properly.

  • Go to Jetpack → Settings → Performance and confirm Enable Site Accelerator is toggled on.
  • Check your site's Site Health tool (Tools → Site Health) to verify there are no critical connection issues with Jetpack.
  • Ensure your site's xmlrpc.php file is accessible, as it is required for Jetpack to communicate with your site.

2. Force the CDN to Refresh an Image

If a specific image won't update on your site, the most effective solution is to force the CDN to fetch a new copy.

  • Solution: Upload a new version of the image with a completely different filename. Simply re-uploading the image with the same name often does not work. For example, change my-image.jpg to my-image-v2.jpg.
  • Replace the image in your post or page with the new file.

3. Check for Conflicts

A conflicting plugin or theme is a very common culprit.

  • Test with a Default Theme: Temporarily switch to a default WordPress theme like Twenty Twenty-Four. If the problem resolves, the issue lies with your regular theme.
  • Disable Other Plugins: Deactivate all plugins except Jetpack. If the issue is fixed, reactivate your plugins one by one to identify which one is causing the conflict. Pay special attention to other image optimization, caching, or gallery plugins.
  • Look for specific settings in other plugins that might control CDN or image handling and disable them if they overlap with Jetpack's functionality.

4. Troubleshoot Gallery Issues

If your tiled galleries or carousels are broken, try these steps:

  • Confirm Feature is Enabled: Ensure Enable the carousel feature is turned on in Jetpack → Settings → Writing.
  • Classic Editor Blocks: For galleries created with the Classic Editor, ensure you are using the correct 'Classic Gallery' block in the block editor to maintain functionality.
  • Clear Caches: Clear any caching on your site (server, plugin, or browser cache) after making changes to Jetpack settings.

5. Address Newsletter Image Problems

Fixing distorted images in emails can be challenging due to email client restrictions.

  • Try using images with a standard aspect ratio (e.g., 4:3 or 16:9).
  • Avoid using complex CSS or HTML wrappers around images in your posts, as this code is often stripped or misinterpreted by email clients.
  • Test your newsletters by sending previews to different email accounts (Gmail, Outlook, Apple Mail) to see if the issue is universal or client-specific.

6. General Best Practices

  • Always clear your browser cache and your site's cache after changing Jetpack settings or images.
  • Ensure your WordPress, theme, and all plugins (especially Jetpack) are updated to their latest versions.
  • When reporting an issue, be prepared to provide the URL of a page where the problem is visible, as this is the first thing needed to diagnose most problems.

When to Seek Further Help

If you have worked through these steps and your issue persists, the problem may be more complex. The next step is to seek help from the wider community. When you do, be sure to include:

  • The exact URL of a page demonstrating the problem.
  • The steps you have already taken to troubleshoot.
  • The names and versions of your active theme and plugins.

By following this structured approach, you can resolve the majority of common Jetpack image and gallery issues and get your site looking perfect again.

Related Support Threads Support