HTML handling

Forcing or dropping trailing slashes on request paths (for example, example.com/page/ vs. example.com/page) is often something that developers wish to control for cosmetic reasons. Additionally, it can impact SEO because search engines often treat URLs with and without trailing slashes as different, separate pages. This distinction can lead to duplicate content issues, indexing problems, and overall confusion about the correct canonical version of a page.

The assets.html_handling configuration determines the redirects and rewrites of requests for HTML content. It is used to specify the pattern for canonical URLs, thus where Cloudflare serves HTML content from, and additionally, where Cloudflare redirects non-canonical URLs to.

Take the following directory structure:

This will usually give you the desired behavior automatically: individual files (e.g. foo.html) will be served without a trailing slash and folder index files (e.g. foo/index.html) will be served with a trailing slash.

{
	"name": "my-worker",
	// Set this to today's date
	"compatibility_date": "2026-07-20",
	"assets": {
		"directory": "./dist/",
		"html_handling": "auto-trailing-slash"
	}
}

name = "my-worker"
# Set this to today's date
compatibility_date = "2026-07-20"

[assets]
directory = "./dist/"
html_handling = "auto-trailing-slash"

Based on the incoming requests, the following assets would be served:

Alternatively, you can force trailing slashes (force-trailing-slash).

{
	"name": "my-worker",
	// Set this to today's date
	"compatibility_date": "2026-07-20",
	"assets": {
		"directory": "./dist/",
		"html_handling": "force-trailing-slash"
	}
}

name = "my-worker"
# Set this to today's date
compatibility_date = "2026-07-20"

[assets]
directory = "./dist/"
html_handling = "force-trailing-slash"

Based on the incoming requests, the following assets would be served:

Or you can drop trailing slashes (drop-trailing-slash).

{
	"name": "my-worker",
	// Set this to today's date
	"compatibility_date": "2026-07-20",
	"assets": {
		"directory": "./dist/",
		"html_handling": "drop-trailing-slash"
	}
}

name = "my-worker"
# Set this to today's date
compatibility_date = "2026-07-20"

[assets]
directory = "./dist/"
html_handling = "drop-trailing-slash"

Based on the incoming requests, the following assets would be served:

Alternatively, if you have bespoke needs, you can disable the built-in HTML handling entirely (none).

{
	"name": "my-worker",
	// Set this to today's date
	"compatibility_date": "2026-07-20",
	"assets": {
		"directory": "./dist/",
		"html_handling": "none"
	}
}

name = "my-worker"
# Set this to today's date
compatibility_date = "2026-07-20"

[assets]
directory = "./dist/"
html_handling = "none"

Based on the incoming requests, the following assets would be served: