From ff3473cd0392ce1c920b1c8d3026cce373ccc09f Mon Sep 17 00:00:00 2001 From: James White Date: Wed, 17 Jun 2026 18:46:38 +0100 Subject: [PATCH 1/5] add owner stream clarification --- content/licensing/2.telemetry.md | 40 ++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) diff --git a/content/licensing/2.telemetry.md b/content/licensing/2.telemetry.md index 01b293cb..9cf0b2fa 100644 --- a/content/licensing/2.telemetry.md +++ b/content/licensing/2.telemetry.md @@ -91,3 +91,43 @@ To opt out, set the `TELEMETRY` [environment variable](/configuration/general#te ::callout{icon="i-lucide-info"} Whether you can disable telemetry depends on your license. Some licenses require telemetry to remain enabled, in which case the `TELEMETRY` setting is ignored. To check whether yours allows it, review your entitlements under **Settings → License** in the Studio. :: + +## Project Owner Registration + +Separately from the usage data described above, Directus sends a one-time project owner registration when an owner is first set for your instance. This associates the project with a point of contact and, where you opt in, registers you for product updates. + +This is a distinct, send-once message. It is not part of the recurring usage report and is sent through a different mechanism. + +### What Is Sent + +| Field | What it is | +| --- | --- | +| `project_owner` | The registered owner and primary contact for the instance, taken from the onboarding form or the `PROJECT_OWNER` environment variable. This is typically an email address. | +| `org_name` | The organization name entered during onboarding, if provided. | +| `project_usage` | How the project is used: `personal`, `commercial`, or `community`. | +| `product_updates` | Whether you opted in to receive product updates (`true`/`false`). | +| `project_id` | The same random project identifier used in the usage report. | +| `version` | The Directus version in use. | + +### When It Is Sent + +The registration is sent once, at the moment a project owner is first set. An owner is set when you: + +- complete the onboarding form in the Studio, +- set the `PROJECT_OWNER` environment variable before bootstrapping a new project, or +- upgrade to Directus 12 with a valid `PROJECT_OWNER` value configured. + +If the initial send fails, Directus retries once per day until it succeeds, then stops. This is not a recurring beacon. Once the registration is delivered, it is never sent again unless a new owner is set. + +### Where It Is Sent + +The registration is sent to `https://telemetry.directus.io`. + +### Relationship to Telemetry and Licensing + +This registration is independent of both the usage report and the licensing service: + +- It is not controlled by the `TELEMETRY` environment variable. Setting `TELEMETRY=false` stops the usage report (entitlement permitting) but does not currently prevent the project owner registration from being sent. +- It does not contact or depend on the licensing service. + +The only way to avoid sending the registration is to not set a project owner, which means skipping the onboarding form and leaving `PROJECT_OWNER` unset. From b99419a6874c3300017636844df6ccf53d7cdc28 Mon Sep 17 00:00:00 2001 From: James White Date: Wed, 17 Jun 2026 18:49:17 +0100 Subject: [PATCH 2/5] clarification --- content/licensing/2.telemetry.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/licensing/2.telemetry.md b/content/licensing/2.telemetry.md index 9cf0b2fa..505df422 100644 --- a/content/licensing/2.telemetry.md +++ b/content/licensing/2.telemetry.md @@ -96,7 +96,7 @@ Whether you can disable telemetry depends on your license. Some licenses require Separately from the usage data described above, Directus sends a one-time project owner registration when an owner is first set for your instance. This associates the project with a point of contact and, where you opt in, registers you for product updates. -This is a distinct, send-once message. It is not part of the recurring usage report and is sent through a different mechanism. +This is a distinct, send-once message. It is not part of the recurring usage report: it is triggered when an owner is set, rather than sent on the telemetry schedule. ### What Is Sent From 1bc72388cdce160ebd2227960dbefb470e26f671 Mon Sep 17 00:00:00 2001 From: James White Date: Wed, 17 Jun 2026 18:50:40 +0100 Subject: [PATCH 3/5] Apply suggestion from @JamesW1 --- content/licensing/2.telemetry.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/licensing/2.telemetry.md b/content/licensing/2.telemetry.md index 505df422..baa68d2d 100644 --- a/content/licensing/2.telemetry.md +++ b/content/licensing/2.telemetry.md @@ -96,7 +96,7 @@ Whether you can disable telemetry depends on your license. Some licenses require Separately from the usage data described above, Directus sends a one-time project owner registration when an owner is first set for your instance. This associates the project with a point of contact and, where you opt in, registers you for product updates. -This is a distinct, send-once message. It is not part of the recurring usage report: it is triggered when an owner is set, rather than sent on the telemetry schedule. +This is a distinct, send-once message. It is not part of the recurring usage report: it is triggered when an owner is set or changed, rather than sent on the telemetry schedule. ### What Is Sent From 29b1bb231bd96b431c94f322d8a6c09f825400a2 Mon Sep 17 00:00:00 2001 From: James White Date: Wed, 17 Jun 2026 18:56:08 +0100 Subject: [PATCH 4/5] amends --- content/licensing/2.telemetry.md | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/content/licensing/2.telemetry.md b/content/licensing/2.telemetry.md index baa68d2d..87d94437 100644 --- a/content/licensing/2.telemetry.md +++ b/content/licensing/2.telemetry.md @@ -94,9 +94,9 @@ Whether you can disable telemetry depends on your license. Some licenses require ## Project Owner Registration -Separately from the usage data described above, Directus sends a one-time project owner registration when an owner is first set for your instance. This associates the project with a point of contact and, where you opt in, registers you for product updates. +Separately from the usage data described above, Directus sends a project owner registration the first time an owner is set for your instance. This associates the project with a point of contact and, where you opt in, registers you for product updates. -This is a distinct, send-once message. It is not part of the recurring usage report: it is triggered when an owner is set or changed, rather than sent on the telemetry schedule. +Unlike the recurring usage report, it is sent only when an owner is set or changed, not on a schedule. ### What Is Sent @@ -111,13 +111,12 @@ This is a distinct, send-once message. It is not part of the recurring usage rep ### When It Is Sent -The registration is sent once, at the moment a project owner is first set. An owner is set when you: +An owner is set when you: -- complete the onboarding form in the Studio, -- set the `PROJECT_OWNER` environment variable before bootstrapping a new project, or -- upgrade to Directus 12 with a valid `PROJECT_OWNER` value configured. +- complete the onboarding form in the Studio, or +- set the `PROJECT_OWNER` environment variable before bootstrapping a new project. -If the initial send fails, Directus retries once per day until it succeeds, then stops. This is not a recurring beacon. Once the registration is delivered, it is never sent again unless a new owner is set. +If the initial send fails, Directus retries once per day until it succeeds, then stops. Once delivered, the registration is never sent again unless the owner changes. ### Where It Is Sent From 56c2fa2d8bc05e9e42a0f8968ecc06359a3b58ac Mon Sep 17 00:00:00 2001 From: James White Date: Wed, 17 Jun 2026 18:59:07 +0100 Subject: [PATCH 5/5] add last point: --- content/licensing/2.telemetry.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/content/licensing/2.telemetry.md b/content/licensing/2.telemetry.md index 87d94437..e825537e 100644 --- a/content/licensing/2.telemetry.md +++ b/content/licensing/2.telemetry.md @@ -113,8 +113,9 @@ Unlike the recurring usage report, it is sent only when an owner is set or chang An owner is set when you: -- complete the onboarding form in the Studio, or -- set the `PROJECT_OWNER` environment variable before bootstrapping a new project. +- complete the onboarding form in the Studio, +- set the `PROJECT_OWNER` environment variable before bootstrapping a new project, or +- update the project owner in **Settings** in the Studio or through the API. If the initial send fails, Directus retries once per day until it succeeds, then stops. Once delivered, the registration is never sent again unless the owner changes.