Deploy to Cloudflare Pages

Before you start

• A Cloudflare account

• A Cloudflare Pages project created in that account

• An Account API token with Cloudflare Pages → Edit permission

Single files must stay under 25 MiB

Cloudflare Pages allows a maximum of 25 MiB for each individual site asset. Compress large images and videos before deploying, or host larger files separately, such as in Cloudflare R2.

Create an API token

1. In the Cloudflare dashboard, select the account you want to deploy under.

2. Go to Manage Account → Account API Tokens and click Create Token.

3. Give the token a name, such as Swebsy Pages deploy.

4. Add a permission policy for Cloudflare Pages with Edit access.

5. Optional: if Swebsy will help attach a custom domain, add DNS → Edit access scoped to the zone that hosts the domain.

6. Click Continue to summary → Create Token, then copy the token.

One-time setup in Swebsy

1. Click Settings in the topbar, then open the Deployment tab.
2. Under Cloudflare Pages, paste your API token.

3. Paste your Account ID from the Cloudflare dashboard sidebar or the token confirmation screen.

4. Pick an existing Pages project from the list. If you do not have one yet, create it in Cloudflare Pages first, then refresh the project list in Swebsy.

5. Optionally enter a custom domain.
6. Click Save.

Cloudflare Pages configuration lives in Settings → Deployment.

Deploy

1. Click the Deploy menu in the topbar.
2. Select Cloudflare Pages.

3. The Deploy review modal opens, showing the target project, live URL, pages, upload size, and any warnings.

4. Click Deploy now.

Choose Cloudflare Pages from the Deploy menu.

Review the generated deployment plan before clicking Deploy now.

Expected result

Your site is live at the Pages project URL shown in the review modal, such as https://<project-name>.pages.dev. Subsequent deploys update the selected project.

Custom domain

If you entered a custom domain in Swebsy, make sure its DNS points at the Pages project:

1. Open your Pages project → Custom domains → Add a custom domain.
2. Follow the DNS instructions Cloudflare provides.

Common issues

“Authentication error” — your token may have expired or have insufficient permissions. Create a new token with Account → Cloudflare Pages → Edit permission.

Project not found — create the Pages project in Cloudflare first, then return to Settings → Deployment, refresh the Pages project list, and pick it again.

Large site times out — very large sites (>50 pages, many images) may hit Cloudflare’s Direct Upload limits. Try reducing image sizes before deploying.

Single file upload fails — Cloudflare Pages rejects individual site assets larger than 25 MiB. Compress the file or host it outside the Pages deploy.