Beginner’s Guide to Cloudflare Pages 2026

If you have ever wondered how to deploy a website to Cloudflare Pages for free, this guide walks you through the entire process — from signing up to pushing live on a *.pages.dev URL with automatic SSL. Cloudflare Pages is a JAMstack and static-site hosting platform that runs on Cloudflare’s global edge network, and its free plan is one of the most generous in the hosting space.

Verdict

StacksFree Verdict: 9 / 10

Cloudflare Pages offers unlimited bandwidth and static asset requests with zero egress charges, 500 builds per month, 100 custom domains per project, and up to 100 projects per account — all without requiring a credit card. The only meaningful limits are a single concurrent build at a time, a 20-minute build timeout, and the fact that Pages Functions share a quota with the Cloudflare Workers Free plan (100,000 requests per day). For static sites and lightweight JAMstack projects, this free tier is nearly unbeatable. For full details see the Cloudflare Pages free tier directory entry.

How This Guide Was Built

This review is based on official Cloudflare documentation, pricing pages, and community reports. We verified the free-tier limits, signup flow, first-deploy steps, and platform availability directly against Cloudflare’s published docs updated in July and August 2026. We did not test paid Cloudflare features — steps for those are based on official docs. Last verified: August 2026.

What is Cloudflare Pages?

Cloudflare Pages is a static-site and JAMstack hosting platform built on Cloudflare’s edge CDN. It deploys directly from Git repositories, runs your build command on every push, and serves the result from data centers worldwide — with unlimited bandwidth for static assets on the free plan Cloudflare Pages product page.

For projects that need server-side logic, Cloudflare Pages integrates tightly with Cloudflare Workers through a /functions directory — giving you access to serverless compute, KV storage, R2 object storage, and more from a single project.

How do I deploy a website to Cloudflare Pages for free?

You deploy a website to Cloudflare Pages for free by creating a Cloudflare account, connecting a GitHub or GitLab repository, configuring your build command and output directory, and pushing the project live — all within a few minutes and with no credit card required. The platform then assigns you a *.pages.dev subdomain with automatic HTTPS, and you can optionally add a custom domain. Let’s walk through the steps.

Step-by-Step: Deploying Your First Site

Deploying your first site to Cloudflare Pages takes about ten minutes: create a free account, connect a GitHub or GitLab repository, set your build command and output directory, and press deploy — no credit card required Cloudflare Pages getting started docs. Here are the exact steps.

Step 1 — Create a free Cloudflare account. Go to dash.cloudflare.com and sign up. The free plan does not require a credit card.

Step 2 — Navigate to Workers & Pages. Once logged in, click “Workers & Pages” in the left sidebar, then choose “Create” and select “Pages.”

Step 3 — Connect your Git repository. Choose GitHub or GitLab, authenticate, and select the repository you want to deploy. Cloudflare will request read access to that repo.

Step 4 — Configure your build settings. Pick your framework preset if one is auto-detected (Cloudflare supports Astro, Next.js static export, React, Vue, Svelte, Hugo, Jekyll, and more), or enter a custom build command and output directory. A typical configuration might look like:

• Build command: npm run build
• Build output directory: dist

Step 5 — Deploy. Click “Save and Deploy.” Cloudflare runs your build command, uploads the output to the edge network, and assigns your project a URL like my-project.pages.dev. Subsequent pushes to your connected branch trigger automatic re-deploys.

Step 6 — Add a custom domain (optional). In your Pages project dashboard, go to “Custom domains,” enter your domain, and follow the DNS configuration prompts. Cloudflare provisions an SSL certificate automatically.

If you prefer not to use Git, you can also deploy via direct upload in the dashboard or by running the Wrangler CLI:

npx wrangler pages deploy dist/

The Pages getting started docs cover all three deployment methods in detail.

Cloudflare Pages Free Tier Limits

The Cloudflare Pages free plan gives you 500 builds per month, unlimited bandwidth for static assets, 100 custom domains per project, 20,000 files per site, and 100 projects per account — per the official Cloudflare Pages limits docs. Here’s the full breakdown.

Resource	Free Tier Limit
Builds	500 per month, 1 at a time, 20-minute timeout
Bandwidth	Unlimited — static requests are free with no egress charges
Custom domains	100 per project
Files per site	20,000
Max single file size	25 MiB
Projects per account	100
Preview deployments	Unlimited
Redirects (_redirects)	2,000 static + 100 dynamic (2,100 total)
Pages Functions	100,000 requests/day (Workers Free quota), 10 ms CPU per invocation

These limits are sourced from the Cloudflare Pages limits docs and the Workers pricing docs.

Adding Serverless Logic with Pages Functions

Pages Functions run serverless code from a /functions folder in your Pages project, and on the free plan they share the Workers quota of 100,000 requests per day with 10 ms of CPU per invocation, per the official Workers pricing docs.

Each function invocation counts against the Cloudflare Workers Free plan quota: 100,000 requests per day with 10 milliseconds of CPU time per invocation. The free plan also bundles Workers KV (100,000 reads/day, 1,000 writes/day, 1 GB stored), R2 object storage (10 GB-month with free egress), Queues (10,000 ops/day), and Workers Logs (200,000 events/day with 3-day retention). This makes Pages a strong choice for sites that mix static frontends with lightweight API endpoints. The Pages Functions docs explain routing, middleware, and advanced patterns.

If your project heavily uses object storage alongside Pages, our Cloudflare R2 free tier guide covers that service’s free limits in depth.

Common Mistakes to Avoid

Forgetting to set the correct output directory. Most build tools output to dist, build, or .next. If you leave this blank or set the wrong path, Cloudflare will deploy an empty site. Always check your framework’s documentation for the correct directory.

Hitting the single concurrent build limit. The free plan allows only one build at a time. If you push multiple commits quickly, builds queue up. Batch changes when possible or wait for each deploy to finish.

Exceeding the 20-minute build timeout. Large projects with heavy dependencies may time out. Optimize your build process by pruning unused packages or caching dependencies in your build configuration.

Ignoring the 20,000-file limit per site. Projects with many small assets — such as uncompressed image directories — can silently exceed this cap. Use optimized asset pipelines and consider offloading media to R2 or a CDN.

FAQ

Is Cloudflare Pages free for beginners?

Yes, Cloudflare Pages is completely free for beginners. The free plan includes unlimited bandwidth, 500 builds per month, 100 custom domains per project, and access to Pages Functions — all without requiring a credit card. You only pay if you upgrade to a Pro, Business, or Enterprise Cloudflare plan, which is entirely optional.

Does Cloudflare Pages charge for bandwidth?

No, Cloudflare Pages does not charge for bandwidth. According to Cloudflare’s official pricing documentation, requests to static assets are free and unlimited with no egress charges applied. This is one of the most generous bandwidth policies among free hosting providers.

Do I need a credit card to use Cloudflare Pages?

No, you do not need a credit card to use Cloudflare Pages. Signing up for a free Cloudflare account and deploying to the free plan requires only an email address. Payment information is only requested if you choose to upgrade to a paid plan or add paid add-ons like additional Workers KV storage.

Where to Go Next

Now that your site is live on Cloudflare Pages, consider exploring related tools in the Cloudflare ecosystem and comparing alternatives:

• Cloudflare R2 free tier guide — pair Pages with R2 for media storage at zero egress cost
• Vercel free tier guide — a head-to-head comparison with another popular JAMstack host
• Cloudflare Pages free tier — our full directory entry with quick-reference specs

For hands-on details on every feature, the Cloudflare Pages official documentation is the definitive reference.