How to add Sentry error tracking to a Webflow Cloud app and stop flying blind in production
Webflow’s guide shows that a functional Sentry hookup on its Cloud platform hinges on a single, non‑obvious tweak: the compatibility_date field in the wrangler.jsonc must be set to 2025‑08‑16 or later. Without this, the Sentry client initializes but silently drops events, leaving teams blind to production failures. The instructions also require using the proper Sentry packages—@sentry/nextjs for Next.js v15+ sites and a duo of @sentry/astro plus @sentry/cloudflare for Astro projects—plus storing the DSN in Webflow Cloud’s environment‑variable UI and ensuring Node 20+ is used locally to match the cloud build environment.
This move reflects a broader push among low‑code and JAMstack hosting services to embed full‑stack observability without forcing users into separate monitoring stacks. By leveraging Cloudflare Workers as its runtime, Webflow Cloud inherits the same compatibility constraints that affect other edge platforms, and the need to pin a future compatibility date mirrors recent Cloudflare updates that deprecate older APIs. The guidance also aligns with the industry trend of treating error tracking as a core deployment concern rather than an after‑thought add‑on, positioning Webflow against competitors like Vercel and Netlify that already ship built‑in telemetry options.
Developers should watch for two practical risks: first, the reliance on a future compatibility date could break if Cloudflare changes its versioning schedule, requiring teams to update wrangler.jsonc periodically; second, the environment‑variable injection happens at runtime only, so any build‑time code that accesses process.env.SENTRY_DSN will cause failures. As Webflow Cloud expands support for other frameworks, the documentation will need to stay current with SDK version changes and Node.js requirements, and users may need to audit their CI pipelines to avoid hard‑coded secrets.
Key Takeaways
Setting compatibility_date to 2025‑08‑16 or later is essential for Sentry events to reach the dashboard on Webflow Cloud.
Next.js apps require only @sentry/nextjs, while Astro sites need both @sentry/astro and @sentry/cloudflare for full coverage.
The DSN must be stored as a runtime environment variable; referencing it during the build will abort the deployment.
Using Node 20+ locally aligns with Webflow Cloud’s build environment and prevents dependency mismatches.
About the Source
This analysis is based on reporting by Webflow Blog. Here is a short excerpt for context:
Learn how to add Sentry error tracking to a Webflow Cloud app. Covers SDK setup for Next.js and Astro.Read the original at Webflow Blog