Docs

Pods

3 min readUpdated November 9, 2026

This page explains how WP Media Cloud works with Pods. File, Image and Video fields serve CDN URLs with no setup, in both postmeta and Table Storage mode.

What the integration does#

Pods card on the Integrations tab

Pods File, Image and Video fields store attachment IDs. When Pods outputs a field, it turns each ID into a URL with standard WordPress attachment functions. WP Media Cloud filters those functions at priority 99 and returns the CDN URL for every offloaded file.

These Pods output paths go through the filtered functions:

Pods outputWordPress function it uses
File field displaywp_get_attachment_url()
pods_image() helperwp_get_attachment_image()
pods_image_url() helperwp_get_attachment_image_src()
Gallery outputThe WordPress gallery shortcode, which calls wp_get_attachment_image()
Magic tags such as {@field._src} and {@field._img}The same image functions

The rewrite happens on the fly as pages load. WP Media Cloud does not change your Pods data and adds no Pods hooks of its own. The Pods class only detects Pods and reports its status.

Table Storage. With the Table Storage component, Pods keeps field values in its own _pods_{pod_name} table instead of postmeta. The values are still attachment IDs, so the same URL filters apply. Table Storage makes no difference.

Avatar field. WP Media Cloud has no special handling for the Pods Avatar field.

What you need to switch on#

There is no Pods setting in WP Media Cloud. Check these:

  1. Go to Media Cloud > Settings and make sure Rewrite URLs is on in the Offload Behaviour card.
  2. Offload your existing media with Offload All Media in the Dashboard Bulk Offload card. Fields only get CDN URLs for files that are offloaded.
  3. Open Media Cloud > Integrations. The Pods card shows Active. This status can take up to 5 minutes to update after you activate Pods.

Limits#

  • Only attachment IDs are rewritten by ID. Text, website and paragraph fields that hold a typed URL keep the URL you saved. Use URL Replace (beta) for those.
  • The attachment GUID is not rewritten. WordPress does not filter the guid column. A template that prints {@field.guid} shows the original upload URL. Use {@field._src} instead.

Troubleshooting#

What you seeWhat it meansHow to fix it
An Image field shows a local URLRewrite URLs is off, or the file is not offloadedTurn on Rewrite URLs, then run Offload All Media
Some gallery images are localEach image is rewritten on its own, and some are not offloaded yetIn Media > Library (list view), offload rows that show Offload now, or retry failed items in the Bulk Offload card
A magic tag prints a local URLThe template prints the GUID or a stored text URLUse ._src or ._img magic tags
Table Storage is on and URLs are localThe files are not offloaded, or Rewrite URLs is offSame as the first row. Table Storage itself is not the cause

This website uses cookies to enhance your browsing experience and ensure the site functions properly. By continuing to use this site, you acknowledge and accept our use of cookies.

Accept All Accept Required Only