Images Sync for Cloudflare

Images Sync for Cloudflare automatically uploads your WordPress images to Cloudflare Images and stores optimized delivery URLs directly in post meta. Perfect for headless setups, JAMstack sites, or anyone who wants fast, globally-distributed images without changing their workflow.

Why Use This Plugin?

Headless frontends need stable, cacheable CDN URLs. This plugin makes WordPress the source of truth while Cloudflare Images handles delivery and optimization. No custom resolvers needed — just query the meta field.

Features

• Flexible Mappings — Map any image source (Featured Image, ACF fields, post meta) to Cloudflare Images with customizable delivery URL storage
• Preset System — Define reusable presets for OG images, thumbnails, heroes, squares — consistent URLs across your site
• Preview Studio — Visually test how images look with different presets before going live
• Auto-Sync — Images sync automatically on post save, or bulk-process existing content via Action Scheduler
• Flexible Variants — Smart detection prevents broken images and 9429 errors
• Headless-Ready — URLs stored in post meta, perfect for GraphQL/REST API consumption
• WP-CLI Support — wp cfimg sync commands for scripted workflows
• Secure Storage — API token encrypted with libsodium (AES-256 fallback)
• No Lock-in — Your images stay in WordPress Media Library; Cloudflare URLs are plain meta values

Security

Your Cloudflare API token is encrypted at rest using modern cryptography (libsodium or AES-256-CBC with HMAC). The token is never stored in plain text and is only decrypted when making API requests.

Requirements

• Cloudflare account with Cloudflare Images subscription
• API Token with “Cloudflare Images: Edit” permission

External services

This plugin optionally connects to external Cloudflare services to upload, manage, and deliver images. No connection is made until the user configures API credentials and explicitly triggers a sync, test, or preview action.

Cloudflare Images API

This plugin sends requests to the Cloudflare API (api.cloudflare.com).

Data sent to Cloudflare (only when the user configures credentials and triggers actions):

• API token — for authentication (sent as a Bearer token header, never logged or stored in plain text)
• Image files — binary content of WordPress media attachments
• Image metadata — WordPress attachment ID and a purpose label (e.g. “preview”)

• Configuration updates — Flexible Variants enable/disable flag

• Cloudflare Terms of Service

• Cloudflare Privacy Policy
• Cloudflare API Documentation

Cloudflare Image Delivery

Delivery URLs use the Cloudflare Image Delivery CDN (imagedelivery.net). These URLs are stored in post meta and served directly to site visitors by their browsers. The plugin itself makes one request to this service to detect Flexible Variants support (canary check).

No visitor data, IP addresses, cookies, or personal information is ever sent to Cloudflare by this plugin.

• Cloudflare Terms of Service
• Cloudflare Privacy Policy
• Cloudflare Images Documentation

Privacy Policy

This plugin does not collect, store, or transmit any personal user data. Only image files and technical metadata (attachment IDs, image hashes) are sent to Cloudflare.

Credits

Developed by 301st with Claude AI.