Skip to main content

Troubleshooting

Screenshot is stuck on Pending​

WP-Cron only fires when your site receives a visitor. On low-traffic sites or immediately after publishing, there may be a delay. Wait a few minutes and check again, or click Regenerate Now in the block editor sidebar to force an attempt on the next page load.

If the status remains Pending for more than 15-20 minutes on an active site, check the plugin log at OG Images > Settings > Logs for errors.

The Logs tab in the plugin settings

Screenshot shows Failed​

Open the plugin log for details on the specific error. Common causes:

  • licence_inactive - your PlugUpp licence has expired or been deactivated. Check your account at plugupp.com.
  • proxy_unavailable - the PlugUpp screenshot service was temporarily unreachable. The plugin will retry automatically. If the problem persists, check status.plugupp.com.
  • Quota exceeded - your monthly screenshot allowance is exhausted. The post will be re-queued automatically when your quota resets on your next billing date. Existing screenshots continue to be served normally in the meantime. If you are running out of quota regularly, see Capacity planning for the levers you can pull to bring usage back in line, including switching some content to Featured-image or Off sources (which do not burn quota).

Regenerate Now button is greyed out​

The button is disabled when:

  • The post's resolved Image source is not Auto-screenshot (and not Featured-image-with-fallback-where-no-Featured-Image-is-set). Featured / Custom / Off / FwF-with-FI all use an existing image rather than capturing a new one, so there is no screenshot to regenerate. The help text below the button confirms which case applies. Change the Image source in the sidebar to Auto-screenshot to re-enable the button.
  • You have just changed the Image source but not yet saved the post. Save the post and the button activates.
  • The plugin has not yet been activated (no PlugUpp connection).
  • Your WordPress Site Address is http:// rather than https:// (the screenshot service requires HTTPS).

My site address starts with http:// - the plugin will not capture​

The PlugUpp screenshot service only captures pages from https:// URLs. If your WordPress Site Address (Settings -> General) is configured as http://..., the plugin's pre-flight check blocks Regenerate Now, Regenerate All, and the daily refresh with an actionable message rather than silently failing every capture.

To fix: switch your site to HTTPS via your hosting provider, then update Site Address to https://... under Settings -> General. Most managed hosts provide a free SSL certificate via Let's Encrypt; check your hosting documentation for the exact steps.

OG image is not appearing in page source​

  1. Confirm the post status shows Ready in the block editor sidebar (for Auto-screenshot or FwF sources), or that a Featured Image / Custom image is set (for Featured / Custom sources).
  2. Check the Image Source for this post in the sidebar. If it is Off, the plugin is intentionally not emitting an og:image for this page.
  3. Check that caching plugins or a CDN are not serving a stale version of your page.
  4. If you have a security plugin, confirm it is not blocking REST API requests to /wp-json/doig/v1/.

Screenshots look wrong or outdated​

Click Regenerate Now in the block editor sidebar to queue a fresh capture. If screenshots are consistently outdated across the site, check the refresh interval setting in OG Images > Settings.

The Regenerate All button ran but nothing changed​

The Regenerate All button on the Dashboard queues all eligible posts for processing - the actual captures happen in the background via WP-Cron and may take some time on sites with many posts. Check the plugin log to confirm jobs are being processed. Posts whose Image Source is Featured / Custom / Off are intentionally skipped (no screenshot needed); the log line for the run reports how many were queued versus how many were skipped.

Logs show no activity​

WP-Cron may not be running. This is common on sites with very low traffic, or sites that have disabled WP-Cron without setting up a server-side cron job as a replacement. Contact your hosting provider or refer to the WordPress documentation on configuring WP-Cron.

Approaching your monthly quota​

If your site has hundreds or thousands of pages - large WooCommerce stores, property listing sites, programmatic-SEO content - the monthly screenshot allowance can be exhausted long before all pages are covered. The arithmetic is fixed (pages x (30 / refresh_interval) = monthly screenshots needed); the answer is to be selective about which pages get captured.

Capacity planning walks through the four levers (setting Image Source to Featured / Off for high-volume content types, extending the refresh interval, per-post overrides, and bulk Image Source actions) and covers the four common scenarios where this comes up.