Direct Upload enables you to upload your prebuilt assets to Pages and deploy them to the Cloudflare global network. This guide will instruct you how to upload your assets using Wrangler or the drag and drop method.
After you have your prebuilt assets ready, there are two ways to begin uploading:
Supported file types
Below is the supported file types for each Direct Upload options:
- Wrangler: A single folder of assets. (Zip files are not supported.)
- Drag and drop: A zip file or single folder of assets.
Set up Wrangler
Create your project
$ npx wrangler pages project create
You will then be prompted to specify the project name. Your project will be served at
<PROJECT_NAME>.pages.dev (or your project name plus a few random characters if your project name is already taken). You will also be prompted to specify your production branch.
Subsequent deployments will reuse both of these values (saved in your
Deploy your assets
$ npx wrangler pages deploy <OUTPUT_DIRECTORY>
Your production deployment will be available at
To deploy assets to a preview environment, run:
$ npx wrangler pages deploy <OUTPUT_DIRECTORY> --branch=<BRANCH_NAME>
For every branch you create, a branch alias will be available to you at
If you would like to streamline the project creation and asset deployment steps, you can also use the deploy command to both create and deploy assets at the same time. If you execute this command first, you will still be prompted to specify your project name and production branch. These values will still be cached for subsequent deployments as stated above. If the cache already exists and you would like to create a new project, you will need to run the .
Other useful commands
$ npx wrangler pages project list
$ npx wrangler pages deployment list
Drag and drop
Deploy your project with drag and drop
To deploy with drag and drop:
- Log in to the .
- In Account Home, select your account > Workers & Pages.
- Select Create application > Pages > Upload assets.
- Enter your project name in the provided field and drag and drop your assets.
- Select Deploy.
Your project will be served from
<PROJECT_NAME>.pages.dev. Next drag and drop your build output directory into the uploading frame. Once your files have been successfully uploaded, select Save and Deploy and continue to your newly deployed project.
Create a new deployment
After you have your project created, select Create a new deployment to begin a new version of your site. Next, choose whether your new deployment will be made to your production or preview environment. If choosing preview, you can create a new deployment branch or enter an existing one.
|Upload method||File limit||File size|
|Wrangler||20,000 files||25 MiB|
|Drag and drop||1,000 files||25 MiB|
If using the drag and drop method, a red warning symbol will appear next to an asset if too large and thus unsuccessfully uploaded. In this case, you may choose to delete that asset but you cannot replace it. In order to do so, you must reupload the entire project.
Drag and drop deployments made from the Cloudflare dashboard do not currently support compiling a
functions folder of . To deploy a
functions folder, you must use Wrangler. When deploying a project using Wrangler, if a
functions folder exists where the command is run, that
functions folder will be uploaded with the project.
However, note that a
_worker.js file is supported by both Wrangler and drag-and-drop deployments made from the dashboard.