diff --git a/advanced/subpath/cloudflare.mdx b/advanced/subpath/cloudflare.mdx
index f290c289..6fa9ea7c 100644
--- a/advanced/subpath/cloudflare.mdx
+++ b/advanced/subpath/cloudflare.mdx
@@ -3,49 +3,26 @@ title: "Cloudflare"
description: "Host documentation at a /docs subpath using Cloudflare Workers"
---
-## Create Cloudflare Worker
+To host your documentation at a `/docs` subpath using Cloudflare, you will need to create and configure a Cloudflare Worker.
-Navigate to the `Workers & Pages > Create application > Create worker`. You
-should be presented with the following screen where you can create a new
-Cloudflare worker.
+
+ Before you begin, you need a Cloudflare account and a domain name (can be managed on or off Cloudflare).
+
-
-
-
+## Set up a Cloudflare Worker
+
+Create a Cloudflare Worker by following the [Cloudflare Workers getting started guide](https://developers.cloudflare.com/workers/get-started/dashboard/), if you have not already.
- Keep in mind: If your DNS provider is Cloudflare you should not use proxying for the CNAME record
+ If your DNS provider is Cloudflare, do not use proxying for the CNAME record.
-### Add custom domain
-
-Once the worker is created, click `Configure worker`. Navigate to the worker
-`Settings > Triggers`. Click on `Add Custom Domain` to add your desired domain
-into the list - we recommend you add both the version with and without `www.`
-prepended to the domain.
-
-
-
-
-
-If you have trouble setting up a custom subdirectory,
-[contact our support team](https://mintlify.com/docs/support) and we'll walk you through
-upgrading your hosting with us.
+### Configure routing
-### Edit Worker Script
-
-Click on `Edit Code` and add the following script into the worker's code.
-
-
-
-
+In your Cloudflare dashboard, select **Edit Code** and add the following script into your Worker's code. See the [Cloudflare documentation](https://developers.cloudflare.com/workers-ai/get-started/dashboard/#development) for more information on editing a Worker.
- Edit `DOCS_URL` by replacing `[SUBDOMAIN]` with your unique subdomain and
- `CUSTOM_URL` with your website's base URL.
+ Replace `[SUBDOMAIN]` with your unique subdomain and `[YOUR_DOMAIN]` with your website's base URL.
```javascript
@@ -80,5 +57,31 @@ async function handleRequest(request) {
}
```
-Click on `Deploy` and wait for the changes to propagate (it can take up to a few
+Select `Deploy` and wait for the changes to propagate (it can take up to a few
hours).
+
+### Test your Worker
+
+After your code deploys, test your Worker to ensure it routes to your Mintlify docs.
+
+1. Test using the Worker's preview URL: `your-worker.your-subdomain.workers.dev/docs`
+2. Verify the Worker routes to your Mintlify docs and your website.
+
+### Add custom domain
+
+1. In your [Cloudflare dashboard](https://dash.cloudflare.com/), navigate to your Worker.
+2. Go to **Settings > Domains & Routes > Add > Custom Domain**.
+3. Add your domain.
+
+
+ We recommend you add your domain both with and without `www.` prepended.
+
+
+See [Add a custom domain](https://developers.cloudflare.com/workers/configuration/routing/custom-domains/#add-a-custom-domain) in the Cloudflare documentation for more information.
+
+### Resolve DNS conflicts
+
+If your domain already points to another service, you must remove the existing DNS record. Your Cloudflare Worker must be configured to control all traffic for your domain.
+
+1. Delete the existing DNS record for your domain. See [Delete DNS records](https://developers.cloudflare.com/dns/manage-dns-records/how-to/create-dns-records/#delete-dns-records) in the Cloudflare documentation for more information.
+2. Return to your Worker and add your custom domain.