Pods
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 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 output | WordPress function it uses |
|---|---|
| File field display | wp_get_attachment_url() |
pods_image() helper | wp_get_attachment_image() |
pods_image_url() helper | wp_get_attachment_image_src() |
| Gallery output | The 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:
- Go to Media Cloud > Settings and make sure Rewrite URLs is on in the Offload Behaviour card.
- Offload your existing media with Offload All Media in the Dashboard Bulk Offload card. Fields only get CDN URLs for files that are offloaded.
- 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
guidcolumn. A template that prints{@field.guid}shows the original upload URL. Use{@field._src}instead.
Troubleshooting#
| What you see | What it means | How to fix it |
|---|---|---|
| An Image field shows a local URL | Rewrite URLs is off, or the file is not offloaded | Turn on Rewrite URLs, then run Offload All Media |
| Some gallery images are local | Each image is rewritten on its own, and some are not offloaded yet | In 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 URL | The template prints the GUID or a stored text URL | Use ._src or ._img magic tags |
| Table Storage is on and URLs are local | The files are not offloaded, or Rewrite URLs is off | Same as the first row. Table Storage itself is not the cause |