docs: refine DO_NOT_TRACK release notes

edmundhung · edmundhung · commit 429acd1b9da0 · 2026-07-30T14:27:36.000+01:00
diff --git a/.changeset/nine-taxis-shave.md b/.changeset/nine-taxis-shave.md
@@ -1,9 +1,7 @@
 ---
 "create-cloudflare": minor
-"@cloudflare/workers-utils": minor
-"wrangler": minor
 ---
 
-Support the `DO_NOT_TRACK` environment variable as a telemetry opt-out
+Honor `DO_NOT_TRACK=1` as a telemetry opt-out
 
-Setting `DO_NOT_TRACK=1` (see https://donottrack.sh/) disables telemetry in both Wrangler and `create-cloudflare`. The tool-specific variables `WRANGLER_SEND_METRICS` and `CREATE_CLOUDFLARE_TELEMETRY_DISABLED` still take precedence.
+Create Cloudflare now disables telemetry when `DO_NOT_TRACK=1` is set, regardless of other telemetry settings.
diff --git a/.changeset/workers-utils-do-not-track.md b/.changeset/workers-utils-do-not-track.md
@@ -0,0 +1,7 @@
+---
+"@cloudflare/workers-utils": minor
+---
+
+Add shared support for the `DO_NOT_TRACK` environment variable
+
+Add utilities for recognizing `DO_NOT_TRACK=1` and incorporating it when resolving Wrangler's telemetry preference.
diff --git a/.changeset/wrangler-do-not-track.md b/.changeset/wrangler-do-not-track.md
@@ -0,0 +1,7 @@
+---
+"wrangler": minor
+---
+
+Honor `DO_NOT_TRACK=1` as a telemetry opt-out
+
+Wrangler now disables telemetry when `DO_NOT_TRACK=1` is set, regardless of other telemetry settings.
diff --git a/packages/create-cloudflare/src/__tests__/metrics.test.ts b/packages/create-cloudflare/src/__tests__/metrics.test.ts
@@ -286,6 +286,15 @@ describe("createReporter", () => {
 		expect(sendEvent).toHaveBeenCalledTimes(0);
 	});
 
+	test("DO_NOT_TRACK='1' takes precedence over CREATE_CLOUDFLARE_TELEMETRY_DISABLED='0'", ({
+		expect,
+	}) => {
+		vi.stubEnv("DO_NOT_TRACK", "1");
+		vi.stubEnv("CREATE_CLOUDFLARE_TELEMETRY_DISABLED", "0");
+
+		expect(createReporter().isEnabled).toBe(false);
+	});
+
 	test("sends started and cancelled event to sparrow if the promise reject with a CancelError", async ({
 		expect,
 	}) => {
diff --git a/packages/create-cloudflare/src/metrics.ts b/packages/create-cloudflare/src/metrics.ts
@@ -112,8 +112,8 @@ export function createReporter() {
 
 	function isTelemetryEnabled() {
 		if (
-			process.env.CREATE_CLOUDFLARE_TELEMETRY_DISABLED === "1" ||
-			isDoNotTrackEnabled()
+			isDoNotTrackEnabled() ||
+			process.env.CREATE_CLOUDFLARE_TELEMETRY_DISABLED === "1"
 		) {
 			return false;
 		}
diff --git a/packages/create-cloudflare/telemetry.md b/packages/create-cloudflare/telemetry.md
@@ -82,12 +82,14 @@ Alternatively, you can set an environment variable:
 export CREATE_CLOUDFLARE_TELEMETRY_DISABLED=1
 ```
 
-Create-Cloudflare also honors [`DO_NOT_TRACK`](https://donottrack.sh/), a shared opt-out convention supported across many CLI tools. If you already have it set, telemetry is disabled with no further configuration:
+Create Cloudflare also honors the `DO_NOT_TRACK` environment variable. Set it to `1` to disable telemetry:
 
 ```sh
 export DO_NOT_TRACK=1
 ```
 
+`DO_NOT_TRACK=1` takes precedence over all other telemetry settings.
+
 If you would like to re-enable telemetry, you can run:
 
 ```sh
diff --git a/packages/workers-utils/src/environment-variables/factory.ts b/packages/workers-utils/src/environment-variables/factory.ts
@@ -142,7 +142,7 @@ type VariableNames =
 	/** Disable config watching in ConfigController. */
 	| "WRANGLER_CI_DISABLE_CONFIG_WATCHING"
 
-	/** https://donottrack.sh/ */
+	/** Disable telemetry when set to an opt-out value. */
 	| "DO_NOT_TRACK"
 
 	// ## Docker Configuration
diff --git a/packages/workers-utils/src/environment-variables/misc-variables.ts b/packages/workers-utils/src/environment-variables/misc-variables.ts
@@ -41,9 +41,7 @@ const getDoNotTrackFromEnv = getEnvironmentVariableFactory({
 	variableName: "DO_NOT_TRACK",
 });
 
-/**
- * `DO_NOT_TRACK` is a shared telemetry opt-out convention: https://donottrack.sh/
- */
+/** Whether `DO_NOT_TRACK` is set to a supported telemetry opt-out value. */
 export function isDoNotTrackEnabled(): boolean {
 	const value = getDoNotTrackFromEnv()?.toLowerCase();
 	return value === "1" || value === "true";
@@ -55,15 +53,15 @@ const getWranglerSendMetricsVariableFromEnv =
 	});
 
 /**
- * `WRANGLER_SEND_METRICS` can override whether we attempt to send metrics information to Sparrow.
- *
- * When it is unset, `DO_NOT_TRACK` opts out of sending metrics.
+ * `WRANGLER_SEND_METRICS` controls whether we attempt to send metrics information to Sparrow.
+ * `DO_NOT_TRACK` takes precedence when it is set to an opt-out value.
  */
 export function getWranglerSendMetricsFromEnv(): boolean | undefined {
-	return (
-		getWranglerSendMetricsVariableFromEnv() ??
-		(isDoNotTrackEnabled() ? false : undefined)
-	);
+	if (isDoNotTrackEnabled()) {
+		return false;
+	}
+
+	return getWranglerSendMetricsVariableFromEnv();
 }
 
 /**
diff --git a/packages/wrangler/src/__tests__/metrics.test.ts b/packages/wrangler/src/__tests__/metrics.test.ts
@@ -688,13 +688,13 @@ describe("metrics", () => {
 				});
 			});
 
-			it("should let the WRANGLER_SEND_METRICS environment variable override DO_NOT_TRACK", async ({
+			it("should let DO_NOT_TRACK override the WRANGLER_SEND_METRICS environment variable", async ({
 				expect,
 			}) => {
 				vi.stubEnv("DO_NOT_TRACK", "1");
 				vi.stubEnv("WRANGLER_SEND_METRICS", "true");
 				expect(await getMetricsConfig({})).toMatchObject({
-					enabled: true,
+					enabled: false,
 				});
 			});
 
diff --git a/packages/wrangler/telemetry.md b/packages/wrangler/telemetry.md
@@ -75,13 +75,13 @@ Alternatively, you may set an environment variable to disable telemetry.
 
 `WRANGLER_SEND_METRICS=false`
 
-Wrangler also honors [`DO_NOT_TRACK`](https://donottrack.sh/), a shared opt-out convention supported across many CLI tools. If you already have it set, telemetry is disabled with no further configuration:
+Wrangler also honors the `DO_NOT_TRACK` environment variable. Set it to `1` to disable telemetry:
 
 ```sh
 export DO_NOT_TRACK=1
 ```
 
-Setting `WRANGLER_SEND_METRICS` takes precedence, so `WRANGLER_SEND_METRICS=true` re-enables Wrangler telemetry even when `DO_NOT_TRACK` is set.
+`DO_NOT_TRACK=1` takes precedence over all other telemetry settings.
 
 If you would like to re-enable telemetry globally, you can run:
 
