Registry /
storage / payload-cloud-storage-cf-img-adapter
Install & Compatibility
Where this runs
No compatibility data collected yet for this library.
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
cfImageAdapter
✓ import { cfImageAdapter } from 'payload-cloud-storage-cf-img-adapter'
✗ const cfImageAdapter = require('payload-cloud-storage-cf-img-adapter')
ESM-only since v3; CommonJS require will fail.
default
✓ import cfImageAdapter from 'payload-cloud-storage-cf-img-adapter'
✗ import { cfImageAdapter } from 'payload-cloud-storage-cf-img-adapter'
Default export is the adapter function; named export cfImageAdapter is also available but deprecated.
Configures Payload CMS to use Cloudflare Images as storage adapter for the media collection.
import { buildConfig } from 'payload/config';
import { cloudStorage } from '@payloadcms/plugin-cloud-storage';
import cfImageAdapter from 'payload-cloud-storage-cf-img-adapter';
export default buildConfig({
plugins: [
cloudStorage({
collections: {
media: {
adapter: cfImageAdapter({
accountHash: process.env.CF_ACCOUNT_HASH ?? '',
apiToken: process.env.CF_API_TOKEN ?? '',
accountId: process.env.CF_ACCOUNT_ID ?? '',
}),
},
},
}),
],
});
Errors
Common errors & fixes
Error [ERR_MODULE_NOT_FOUND]: Cannot find module 'payload-cloud-storage-cf-img-adapter'
Trying to require() an ESM-only package in CommonJS context.
fixUse import instead of require, or add type: 'module' to package.json.
TypeError: cfImageAdapter is not a function
Using deprecated named export cfImageAdapter while expecting default export behavior.
fixChange to import cfImageAdapter from 'payload-cloud-storage-cf-img-adapter'.
Audit
Dependencies
payloadrequiredPeer dependency: requires Payload CMS v3.20+
@payloadcms/plugin-cloud-storagerequiredPeer dependency: required plugin for cloud storage integration
webpackrequiredPeer dependency: webpack 5 needed for bundling