●Change8

Migrating to Cloudflare Workers @cloudflare/config@0.3.0

Version @cloudflare/config@0.3.0 introduces 1 breaking change. This guide details how to update your code.

Released: 7/21/2026

1
Breaking Changes
1
Migration Steps
3
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

cloudflare.config.tsdefineSettingsdefineWorker

Breaking Changes

●Issue #1

Account-level settings like `accountId` and `complianceRegion` have moved from the main Worker config to a dedicated `settings` export using `defineSettings`. This change is only applicable when using the experimental new-config path (`wrangler --experimental-new-config` or `@cloudflare/vite-plugin` `experimental.newConfig`). To fix this, refactor your `cloudflare.config.ts` to include a `settings` export for these values.

Migration Steps

  1. 1
    If using the experimental new-config path, update your `cloudflare.config.ts` to define account-level settings (e.g., `accountId`, `complianceRegion`) within a `settings` export using `defineSettings`.

Release Summary

Introduced a dedicated `settings` export in the experimental `cloudflare.config.ts` for account-level configurations. This change enhances the organization of configuration files when using the new-config experimental path.

Need More Details?

View the full release notes and all changes for Cloudflare Workers @cloudflare/config@0.3.0.

View Full Changelog