chore(schema): add field descriptions for telemetry_derived

[chelseyklein]

Schema Update: moz-fx-data-shared-prod.telemetry_derived

Generated by the metadata agent pipeline on 2026-06-08.

Summary

Tables updated	4
Fields described	1247
Probe-matched	1 / 1247
Global.yaml candidates	487
Contradictions flagged	0

How Descriptions Were Generated

1. Data profiling — null rates, distinct values, and value distributions sampled from live BigQuery data
2. Probe context — Legacy telemetry pings (main, crash, event, first-shutdown) via BQ cache; active_users tables have no source ping in DataHub
3. Reconciliation — Claude reconciled observed data with probe definitions

Fields Updated by Table

Table	Fields Described	Probe Matches
active_users_aggregates_v1	17	0/17
clients_daily_joined_v1	423	1/423
clients_daily_v6	395	0/395
clients_first_seen_v1	412	2/412

Global.yaml Candidates

Fields routed to global.yaml — consistent meaning across datasets:

• app_name — The name of the browser or application (e.g., 'Firefox', 'Fenix', 'Firefox iOS').
• attribution_campaign — The attribution campaign identifier from the install attribution, indicating the marketing campaign that drove the installation (utm_campaign value).
• attribution_content — The attribution content identifier from the install attribution, indicating the specific creative or link within a campaign.
• attribution_experiment — The attribution experiment key associated with the install, used to track funnel experiment parameters.
• attribution_medium — The attribution medium from the install attribution, indicating the category of channel that drove the installation (e.g., 'organic', 'referral', 'cpc').
• attribution_source — The attribution source from the install attribution, indicating the referring partner domain or website that drove the installation.
• attribution_variation — The attribution variation key associated with the install, used to track funnel experiment variation parameters.
• city — The city in which the activity took place, as determined by IP geolocation.
• dau — The number of daily active users on the submission date, counting clients that reported at least one qualifying ping.
• mau — The number of monthly active users on the submission date, counting clients that reported at least one qualifying ping in the prior 28 days.
• wau — The number of weekly active users on the submission date, counting clients that reported at least one qualifying ping in the prior 7 days.
• app_name — The name of the browser or application (e.g., 'Firefox Desktop', 'Fenix', 'Firefox iOS').
• app_version — User-visible version string of the browser (e.g. '151.0', '150.0.3').
• attribution_medium — The attribution medium from the install attribution, indicating the category of channel that drove the installation (e.g., 'organic', 'referral', 'cpc').
• attribution_source — The attribution source from the install attribution, indicating the referring partner domain or website that drove the installation.
• os_version — The operating system version string on the client's device (e.g., '10.0' for Windows, '16' for Android).
• activity_segment — Classification of users based on their browsing activity. E.g., infrequent, casual, regular.
• app_name — The name of the application.
• app_version — User visible version string (e.g. "1.0.3") for the browser.
• app_version_major — The major version of the user visible app version string for the browser, e.g. "142.1.3", has major version 142.
• app_version_minor — The minor version of the user visible app version string for the browser, e.g. "142.1.3" has minor version 1.
• attribution_medium — The attribution medium; similar or the same as UTM medium.
• attribution_source — The attribution source; similar or the same as UTM source.
• channel — The normalized channel the application is being distributed on.
• country — Name of the country in which the activity took place, as determined by the IP geolocation.
• dau — The number of daily active users, corresponding to the count of clients that reported at least one ping on the submission_date and qualify as active.
• distribution_id — The distribution id associated with the install of Firefox.
• is_default_browser — A flag indicating whether the browser is set as the default browser on the client side.
• locale — Set of language- and/or country-based preferences for a user interface.
• mau — The number of monthly active users, corresponding to the count of clients that reported at least one ping on the previous 28 days from the submission_date and qualify as active.
• os — The normalized name of the operating system running at the client.
• os_version — Version of the operating system running at the client, e.g. "100.9.11".
• os_version_major — Major or first part of the operating system version running at the client. E.g. for version "100.9.11", the major is 100.
• os_version_minor — Minor part of the operating system version running at the client. E.g. for version "100.9.11", the minor is 9.
• submission_date — The date when the telemetry ping is received on the server side.
• wau — The number of weekly active users, corresponding to the count of clients that reported at least one ping on the previous 7 days from the submission_date and qualify as active.
• activity_segment — User activity segment based on browsing frequency (e.g. 'infrequent_user', 'casual_user', 'core_user', 'regular_user', 'other').
• app_version_major — The major component of the user-visible app version string (e.g. 151 for version '151.0.1').
• app_version_minor — The minor component of the user-visible app version string (e.g. 1 for version '151.1.0').
• app_version_patch_revision — The patch/revision component of the app version. Null (~61%) for versions without a patch number (sampled 2026-06-02).
• is_default_browser — A flag indicating whether the browser is set as the default browser on the client side. Always null for this mobile TOU table (sampled 2026-06-02).
• windows_build_number — The Windows build number (e.g. 22000). Always null for mobile platforms (sampled 2026-06-02).
• app_name — The name of the browser or application (e.g., 'Firefox Desktop', 'Fenix', 'Firefox iOS').
• app_version — User-visible version string of the browser (e.g. '151.0', '150.0.3').
• attribution_medium — The attribution medium from the install attribution, indicating the category of channel that drove the installation (e.g., 'organic', 'referral', 'cpc').
• attribution_source — The attribution source from the install attribution, indicating the referring partner domain or website that drove the installation.
• city — The city in which the activity took place, as determined by IP geolocation.
• os_version — The operating system version string on the client's device (e.g., '10.0' for Windows, '16' for Android).
• app_name — The application name from telemetry.active_users (e.g. 'Firefox Desktop', 'Fenix').
• dau — DAU (daily active users) from telemetry.active_users for this app name and submission_date, as recorded at the time of the DAG run.
• mau — MAU (monthly active users) from telemetry.active_users for this app name and submission_date, as recorded at the time of the DAG run.
• submission_date — The submission date from telemetry.active_users for which this rollup row applies.
• wau — WAU (weekly active users) from telemetry.active_users for this app name and submission_date, as recorded at the time of the DAG run.
• submission_date — The date when the telemetry ping is received on the server side.
• country — The two-letter ISO 3166-1 country code of the client, limited to US, DE, GB, FR, CA, and AU.
• normalized_channel — The normalized Firefox release channel associated with the engagement (e.g. 'release', 'beta').
• submission_date — The date for which engagement counts are aggregated.
• app_channel — The release channel for this application entry, e.g. 'release', 'beta', or 'nightly'.
• app_name — The snake_case application name used internally (e.g. 'firefox_desktop', 'fenix').
• app_build_id — The build ID of the Firefox application, in YYYYMMDDHHMMSS format.
• app_name — The name of the browser application (always 'Firefox' in this table).
• architecture — The CPU architecture of the client's build (e.g., 'x86-64', 'aarch64', 'x86').
• attribution_campaign — The campaign identifier from the install attribution, indicating the marketing campaign that drove the installation.
• attribution_content — The attribution content identifier from the install attribution, indicating the specific creative or link within a campaign.
• attribution_dlsource — Identifier indicating where the Firefox installation originated (e.g., 'mozorg', 'fxdotcom', 'mozillaci').
• attribution_dltoken — A unique token created at Firefox download time to correlate installs with download events.
• attribution_experiment — The attribution experiment key associated with the install.
• attribution_medium — The attribution medium from the install (e.g., 'organic', 'referral', 'cpc').
• attribution_source — The attribution source from the install, indicating the referring domain or partner.
• attribution_ua — The derived user agent type at attribution time (e.g., 'chrome', 'edge', 'firefox').
• attribution_variation — The attribution variation key associated with the install.
• city — The city in which the activity took place, as determined by IP geolocation.
• first_seen_date — The date the server first received a ping from this client, establishing the profile's first-seen date.
• is_desktop — Whether this client is a desktop Firefox installation. True for desktop, false for other platforms.
• normalized_os_version — The normalized operating system version string (e.g., '10.0' for Windows, '6.8.0' for Linux).
• os — The name of the operating system on the client device, as reported by the telemetry environment (e.g. 'Windows_NT', 'Darwin', 'Linux').
• os_version — The operating system version string (e.g., '10.0' for Windows, '6.1' for Windows 7).
• app_build_id — The build ID string of the Firefox application (e.g. '20200403170909'). NULL indicates all build IDs are aggregated together.
• app_version — The major version number of Firefox (e.g. 75, 76). Represents the browser version for which probe counts are aggregated.
• channel — The Firefox release channel from which the data was collected (e.g. 'release', 'beta', 'nightly').
• client_id — A unique identifier (UUID) for the client.
• os — The normalized name of the operating system (e.g. 'Windows', 'Mac', 'Linux'). NULL indicates all operating systems are aggregated together.
• submission_date — The date when the telemetry ping is received on the server side.
• app_build_id — The build ID of the Firefox application (e.g. '20200403170909'). Null for roughly 26% of rows.
• app_version — The integer major version of the Firefox application (e.g. 75, 76). Used to filter rows to recent versions when computing aggregates.
• channel — The normalized release channel the application is distributed on (e.g. release, beta, nightly).
• client_id — A unique identifier (UUID) for the client.
• os — The normalized name of the operating system running at the client. Null for ~45% of rows; observed values include Windows, Linux, and Mac.
• submission_date — The date when the telemetry ping is received on the server side.
• normalized_os_version — The normalized operating system version string (e.g., '10.0' for Windows, '6.8.0' for Linux).
• app_build_id — The build ID of the Firefox application (e.g. '20200403170909').
• channel — The normalized release channel the application is distributed on (e.g. release, beta, nightly).
• os — The normalized name of the operating system running at the client.
• app_build_id — The build ID of the Firefox application in YYYYMMDDHHMMSS format.
• app_name — The name of the browser application (always 'Firefox' for desktop telemetry).
• app_version — The user-visible version string of the Firefox application (e.g. '149.0.2'). Sourced from the URI metadata of the ping.
• attribution.campaign — The campaign identifier from the install attribution.
• attribution.content — The attribution content identifier from the install attribution.
• attribution.dlsource — Identifier indicating where the Firefox installation originated (e.g., 'mozorg', 'fxdotcom').
• attribution.dltoken — A unique token created at Firefox download time to correlate installs with download events.
• attribution.experiment — The attribution experiment key associated with the install.
• attribution.medium — The attribution medium from the install (e.g., 'organic', 'referral', 'cpc').
• attribution.source — The attribution source from the install attribution, indicating the referring partner domain that drove the installation.
• attribution.ua — The derived user agent type at attribution time (e.g., 'chrome', 'edge', 'firefox').
• attribution.variation — The attribution variation key associated with the install.
• city — The city in which the client's activity took place, as determined by IP geolocation.
• experiments — Array of Nimbus/Normandy experiments and rollouts the client is currently enrolled in, with their branch assignments.
• first_seen_date — Date when the server first received a ping from this client.
• isp_name — The name of the internet service provider associated with the client's IP address.
• normalized_os_version — The normalized operating system version string (e.g., '10.0' for Windows, '6.8.0' for Linux).
• os_version — The operating system version string (e.g., '10.0' for Windows, '24.6.0' for macOS).
• app_build_id — The build ID of the Firefox application in YYYYMMDDHHMMSS format.
• app_build_id — The build ID of the Firefox application in YYYYMMDDHHMMSS format.
• app_name — The name of the browser application (always 'Firefox' for desktop telemetry).
• attribution.campaign — The campaign identifier from the install attribution.
• attribution.content — The attribution content identifier from the install attribution.
• attribution.dlsource — Identifier indicating where the Firefox installation originated (e.g., 'mozorg', 'fxdotcom').
• attribution.dltoken — A unique token created at Firefox download time to correlate installs with download events.
• attribution.experiment — The attribution experiment key associated with the install.
• attribution.medium — The attribution medium from the install (e.g., 'organic', 'referral', 'cpc').
• attribution.source — The attribution source from the install attribution, indicating the referring partner domain that drove the installation.
• attribution.ua — The derived user agent type at attribution time (e.g., 'chrome', 'edge', 'firefox').
• attribution.variation — The attribution variation key associated with the install.
• city — The city in which the client's activity took place, as determined by IP geolocation.
• experiments — Array of Nimbus/Normandy experiments and rollouts the client is currently enrolled in, with their branch assignments.
• isp_name — The name of the internet service provider associated with the client's IP address.
• normalized_os_version — The normalized operating system version string (e.g., '10.0' for Windows, '6.8.0' for Linux).
• os_version — The operating system version string (e.g., '10.0' for Windows, '24.6.0' for macOS).
• attribution_campaign — The campaign identifier from the install attribution.
• attribution_content — The attribution content identifier from the install attribution.
• attribution_dlsource — Identifier indicating where the Firefox installation originated (e.g., 'mozorg', 'fxdotcom').
• attribution_dltoken — A unique token created at Firefox download time to correlate installs with download events.
• attribution_experiment — The attribution experiment key associated with the install.
• attribution_medium — The attribution medium from the install (e.g., 'organic', 'referral', 'cpc').
• attribution_source — The attribution source from the install attribution, indicating the referring partner domain that drove the installation.
• attribution_ua — The derived user agent type at attribution time (e.g., 'chrome', 'edge', 'firefox').
• build_id — The Firefox build ID of the client at the time of first seen, in YYYYMMDDHHMMSS format.
• first_seen_date — Date when the server first received a ping from this client, establishing the start of the 28-day observation window.
• os_version — The operating system version of the client as a numeric value.
• app_build_id — The build ID of the Firefox application reported on first seen date, in YYYYMMDDHHMMSS format (sampled 2026-05-29).
• app_name — The name of the browser application; always 'Firefox' in this table (sampled 2026-05-29).
• app_version — The version string of the Firefox application on the first seen date (e.g. '151.0.1') (sampled 2026-05-29).
• attribution.campaign — Identifier of the particular marketing campaign that led to the download of Firefox.
• attribution.content — Identifier indicating the particular link within a campaign that drove the Firefox download.
• attribution.dlsource — Identifier indicating where this Firefox installation originated (e.g., mozorg, fxdotcom, mozillaci).
• attribution.dltoken — Unique token created at Firefox download time, used to link an installation to a specific download event.
• attribution.experiment — Funnel experiment parameter recorded at download time.
• attribution.medium — Category of the traffic source that drove the Firefox download, such as 'referral' for partner referrals.
• attribution.source — Referring partner domain from which Firefox was downloaded, when the install originated via a known partner.
• attribution.ua — The browser user agent used to download the Firefox installer, derived from the download request.
• attribution.variation — Variation parameter of the funnel experiment recorded at download time.
• city — The city in which the client's activity took place, determined by IP geolocation.
• client_id — A unique identifier (UUID) for the client installation.
• country — The ISO 3166-1 alpha-2 country code of the client, determined by IP geolocation at the time of first seen ping (sampled 2026-05-29).
• distribution_id — The identifier of the Firefox distribution (e.g. 'canonical-002', 'mozilla-MSIX', 'mint-001') that supplied this install (sampled 2026-05-29).
• experiments — Array of Nimbus/Normandy experiments the client is enrolled in, with branch assignments.
• first_seen_date — Date when the server first received a ping from this client.
• isp_name — The name of the internet service provider associated with the client's IP address at first seen (sampled 2026-05-29).
• profile_group_id — A UUID identifying the profile group on a single device, used for cross-product correlation.
• sample_id — A number (0–99) derived from client_id for convenient sub-sampling; allows analysts to work on a fraction of the data without biasing by client.
• app_build_id — The build ID of the Firefox application binary, formatted as a timestamp string (e.g. '20260116091309').
• app_build_id — The build ID of the Firefox application, identifying the specific build associated with this client's histogram aggregates. May be '*' when aggregated across all build IDs.
• app_build_id — The build ID of the Firefox application used to compute these per-bucket counts. May be '*' when the row aggregates across all build IDs for a given channel and OS combination.
• app_build_id — The Firefox application build ID, or NULL when this row aggregates across all build IDs (corresponding to '*' in the upstream bucket counts table).
• app_build_id — The build ID of the application, a timestamp-based string identifying the exact Firefox build (e.g. '20260511200624') (sampled 2026-05-29).
• app_name — The name of the browser application; always 'Firefox' for this table (sampled 2026-05-29).
• app_version — User visible version string (e.g. '150.0.3') for the browser (sampled 2026-05-29).
• first_seen_date — Date when the server first received a ping from this client.
• normalized_os_version — Normalized version string of the operating system (e.g. '10.0' for Windows 10, '24.6.0' for a Linux kernel); matches the global os_version alias (sampled 2026-05-29).
• os_version — Raw version string of the operating system as reported by the client (e.g. '10.0' for Windows, '24.6.0' for Linux); high cardinality on Linux (sampled 2026-05-29).
• app_build_id — The build ID of the Firefox application reported by the client on the most recent active day.
• app_name — The name of the application (always 'Firefox' for this table).
• country — The ISO 3166-1 alpha-2 country code determined by IP geolocation of the client on the most recent active day.
• distribution_id — The distribution identifier for the Firefox installation, identifying partnerships or custom builds (e.g., 'canonical-002', 'MozillaOnline').
• first_seen_date — The date when the server first received any telemetry ping from this client.
• is_default_browser — Whether Firefox is set as the default web browser on the client. True means Firefox handles web URLs by default.
• isp_name — The name of the internet service provider associated with the client's IP address on the most recent active day.
• locale — Set of language- and/or country-based preferences for the Firefox user interface (e.g., 'en-US', 'fr', 'zh-CN').
• normalized_channel — The normalized release channel the client is on (e.g., 'release', 'beta', 'nightly', 'esr', 'aurora', 'Other'). Non-standard channel strings are collapsed to 'Other'.
• normalized_os_version — The operating system version string normalized to a consistent format at ingestion (e.g., '10.0' for Windows, '25.3.0' for macOS, '6.17.0' for Linux).
• os_version — The operating system version string as reported by the client before normalization (e.g., '10.0' for Windows, '25.3.0' for macOS, kernel version strings for Linux).
• app_build_id — The build ID of the Firefox application (e.g., '20240509170740'). An asterisk ('*') indicates the value has been aggregated across all build IDs.
• channel — The Firefox release channel from which the client is reporting (e.g., 'release', 'beta', 'nightly').
• channel — The normalized release channel the application is being distributed on (e.g. 'nightly', 'beta', 'release'). (sampled 2026-06-02)
• attribution_campaign — The campaign this client/install was attributed to (utm_campaign value, identifying a specific marketing campaign or promotion).
• attribution_content — The attribution content associated with the install; similar or the same as UTM content.
• attribution_experiment — The attribution experiment key associated with the install, used to track install-time experiment assignments.
• attribution_medium — The attribution medium associated with the install; similar or the same as UTM medium.
• attribution_source — The attribution source associated with the install; similar or the same as UTM source.
• attribution_variation — The attribution variation key associated with the install, identifying which experiment variation the user was exposed to.
• normalized_app_name — The normalized name of the Firefox application variant (e.g., 'Fenix', 'Firefox Desktop', 'Firefox iOS'). Set to 'Other' if the app name was not recognized.
• normalized_os_version — The operating system version normalized to a consistent format at ingestion (e.g., '10.0' for Windows, '16' for Android, '26.3.1' for iOS).
• app_build_id — The build identifier of the application as reported in the core ping URI metadata (e.g., '33292015').
• country — ISO 3166-1 alpha-2 country code of the client, determined by IP geolocation at ingestion.
• default_browser — Whether Firefox is set as the default browser on the client device at the time of the last core ping submission. Null when this information was not reported.
• distribution_id — The distribution identifier associated with the Firefox installation, used to attribute installs to OEM or partner distributions (e.g., 'mozillaonline'). Null for standard Mozilla installs.
• first_seen_date — The date on which the server first received a core ping from this client, joined from core_clients_first_seen_v1.
• locale — The locale of the application during the session (e.g., en-US, fr-FR), representing the most frequently observed value for this client on the submission date.
• normalized_channel — The normalized release channel of the application (e.g., release, beta, nightly). Set to 'Other' if the channel reported by the client was not recognized.
• os — The operating system of the client device (e.g., Android, iOS, iPadOS), representing the most frequently observed value for this client on the submission date.
• app_build_id — The build identifier of the application as reported in the core ping URI metadata on the client's most recently active day.
• first_seen_date — The date on which the server first received a core ping from this client.
• application_name — The normalized application name reporting the crash (always 'Firefox' in this table, sampled 2026-06-02).
• build_id — The application build ID from the crash ping (e.g., '20260514164700'). Represents the modal build ID observed across all crash pings for this client on the day.
• channel — The normalized release channel of the crashing application (e.g., 'release', 'esr', 'beta', 'nightly', 'Other').
• client_id — A unique identifier (UUID) for the client.
• country_code — The ISO 3166-1 alpha-2 country code for the country where the crash occurred, as determined by IP geolocation.
• os — The normalized operating system of the crashing client (e.g., 'Windows', 'Linux', 'Mac').
• os_version — The OS version string of the crashing client (e.g., '10.0', '6.1' for Windows versions). Represents the modal value across all crash pings for this client on the day.
• sample_id — A number, 0-99, that samples by client_id and allows filtering data for analysis. It is a pipeline-generated artifact that should match between pings.
• submission_date — The date when the telemetry crash ping was received on the server side.
• architecture — The CPU architecture of the client device (e.g., 'x86-64', 'aarch64', 'x86').
• attribution_campaign — The campaign this client's install was attributed to, identifying a specific marketing campaign or promotion.
• attribution_content — The attribution content identifier; similar to UTM content, indicating the particular link or creative within a campaign.
• attribution_experiment — The attribution experiment key associated with the client's install, identifying a download-funnel experiment.
• attribution_medium — The attribution medium; similar to UTM medium, indicating the category of traffic source (e.g., 'referral', 'paidsearch').
• attribution_source — The attribution source; the referring domain or partner from which the client installed Firefox (e.g., 'www.google.com').
• attribution_ua — The browser user-agent used to download Firefox, indicating the browser the client was using prior to installation (e.g., 'chrome', 'edge', 'firefox').
• city — City retrieved as a result of a geographic lookup based on the client's IP address. Null when the city cannot be determined.
• first_seen_date — Date when the server first received a ping from this client; used as the cohort assignment date.
• normalized_app_name — The normalized application name (e.g., 'Firefox'). Set to 'Other' if the application name was not recognized.
• normalized_os_version — The operating system version normalized to a consistent format at ingestion (e.g., '10.0' for Windows, '6.17.0' for Linux, '25.3.0' for macOS).
• subdivision1 — The first-level country subdivision (e.g., state, province) determined by IP geolocation, using standard subdivision codes. Null when the subdivision cannot be determined.
• attribution_source — The attribution source; the referring domain or partner from which the client installed Firefox (e.g., 'www.google.com', 'www.bing.com'). Null when no attribution source is recorded.
• attribution_ua — The browser user-agent used to download Firefox, indicating the browser the client was using prior to installation (e.g., 'chrome', 'edge', 'firefox'). Empty string when the UA could not be parsed.
• build_id — The Firefox build identifier string (e.g., '20260516144017'), encoding the date and time the build was compiled.
• os_version — The major.minor version of the operating system on the client at the time of first launch, truncated to the minor component for privacy (e.g., '10', '6.1').
• attribution_source — The referring domain or source from which the Firefox installer was downloaded (e.g. 'www.google.com', 'www.bing.com'). Null for ~60% of new profiles where attribution data was not captured.
• attribution_ua — The browser user agent used to download the Firefox installer. Possible values include 'chrome', 'edge', 'firefox', 'other', 'ie', or empty string when the browser could not be detected.
• channel — The normalized release channel of Firefox on which the new profile was created (e.g. 'release', 'esr', 'beta', 'nightly', 'aurora', 'Other').
• distribution_id — The distribution identifier for the Firefox build, indicating which partner or OEM distribution produced the installer (e.g. 'canonical-002', 'mint-001'). Null for ~71% of new profiles.
• os — The normalized name of the operating system on which the new profile was created (e.g. 'Windows', 'Linux', 'Mac').
• country_code — The ISO 3166-1 alpha-2 country code where the client is located, as determined by IP geolocation. Countries with fewer than 5000 distinct clients may be aggregated into 'OTHER' for privacy.
• app_name — The name of the application that sent the event ping (e.g., 'Firefox').
• attribution_dltoken — A unique token created at Firefox download time, used to link installs to specific download events across attribution pipelines.
• attribution_source — The referring domain or source that led to the Firefox installation, similar to UTM source (e.g., 'www.google.com', 'www.bing.com').
• build_architecture — The CPU architecture for which Firefox was compiled (e.g., 'x86-64', 'aarch64', 'x86'), as recorded at build time.
• build_id — The build ID of the Firefox application, formatted as a date-time string (e.g., '20260520211922'), identifying the specific build that produced the event.
• os_version — The operating system version string at the client, prior to normalization (e.g., '10.0' for Windows, '25.5.0' for macOS, '6.8.0' for Linux).
• timestamp — The server-side timestamp when the event ping was received, used for ordering and joining with other telemetry data.
• submission_date — The date for which this event type snapshot was generated; represents the latest date processed in the incremental update.
• normalized_channel — The normalized release channel of the Firefox client (e.g. 'release', 'beta', 'nightly', 'esr', 'aurora', 'Other'). Set to 'Other' if the reported channel was unrecognized.
• normalized_channel — The normalized release channel of the Firefox client (e.g. 'release', 'beta', 'nightly', 'esr', 'aurora', 'Other'). Null for ~3.7% of rows (sampled 2026-06-02).
• normalized_channel — The normalized release channel of the Firefox client (e.g. 'release', 'beta', 'nightly', 'esr'). Null for ~73% of rows, covering older experiments that lacked channel data (sampled 2026-06-02).
• normalized_channel — The normalized release channel of the Firefox client (e.g. 'release', 'beta', 'nightly', 'esr'). Null for ~30% of rows (sampled 2026-06-02).
• normalized_channel — The normalized release channel of the Firefox client (e.g. 'release', 'beta', 'nightly', 'esr'). No null values in v1 (sampled 2026-06-02).
• submission_date — The date when the telemetry ping is received on the server side.
• normalized_channel — The normalized release channel of the Firefox client (e.g. 'release', 'beta', 'nightly', 'esr'). Null for ~1.6% of rows (sampled 2026-06-02).
• submission_date — The date when the telemetry ping is received on the server side.
• activity_segments_v1 — User engagement segment based on browsing frequency. Values: 'core_user', 'regular_user', 'infrequent_user', 'casual_user', 'other' (sampled 2026-06-02).
• app_version — User visible version string (e.g. '151.0.1') for the browser. The most common value as of sample date was '151.0.1' (sampled 2026-06-02).
• client_id — A unique identifier (UUID) for the client.
• country — ISO 3166-1 alpha-2 code of the country in which the activity took place, as determined by IP geolocation (e.g. 'US', 'DE', 'FR') (sampled 2026-06-02).
• first_seen_date — Date when the server first received a ping from this client.
• is_default_browser — True if Firefox is set as the default browser on the client; false otherwise. True for ~58% of clients (sampled 2026-06-02).
• normalized_os_version — Version of the operating system version running at the client (e.g. '10.0' for Windows 10, '25.5.0' for Linux kernel) (sampled 2026-06-02).
• os — The name of the operating system running on the client (e.g. 'Windows_NT', 'Darwin', 'Linux') (sampled 2026-06-02).
• profile_group_id — A UUID identifying the profile group on a single device, allowing user-oriented correlation of data. Null for ~2.1% of clients (sampled 2026-06-02).
• submission_date — The date when the telemetry ping is received on the server side.
• subsample_id — A number, 0-99, that samples by client_id to allow filtering data for analysis. Uniformly distributed across 100 buckets (sampled 2026-06-02).
• app_version_major — The major version number of the application that crashed (e.g. 115 for Firefox ESR 115, 140 for Firefox 140) (sampled 2026-06-02).
• app_version_minor — The minor version number of the application that crashed (e.g. 36 for Firefox ESR 115.36.0) (sampled 2026-06-02).
• client_info.telemetry_sdk_build — The version of the Glean SDK at the time the crash ping was collected (e.g. '67.2.0') (sampled 2026-06-02).
• document_id — The document ID specified in the URI when the client sent this message, uniquely identifying each crash ping submission.
• normalized_channel — The normalized release channel of the crashing application (e.g. 'release', 'esr', 'beta', 'nightly'). Null for ~73% of rows (older/unrecognized clients) (sampled 2026-06-02).
• normalized_country_code — ISO 3166-1 alpha-2 country code of the client's location, as determined by IP geolocation (e.g. 'US', 'IN', 'FR') (sampled 2026-06-02).
• normalized_os — The normalized name of the operating system on which the crash occurred (e.g. 'Windows', 'Linux', 'Android', 'Mac') (sampled 2026-06-02).
• normalized_os_version — Version of the operating system on which the crash occurred (e.g. '10.0' for Windows 10, '6.1' for Windows 7) (sampled 2026-06-02).
• sample_id — A number, 0-99, that samples by client_id to allow filtering data for analysis; always 17 in this table as it is a sample partition (sampled 2026-06-02).
• submission_timestamp — Timestamp when the crash ping is received on the server side.
• country — ISO 3166-1 alpha-2 country code for the client's location as determined by IP geolocation (e.g. 'US', 'DE', 'CN') (sampled 2026-06-02).
• dau — The number of daily active users, corresponding to the count of clients that reported at least one qualifying ping on the submission date.
• distribution_id — The distribution id associated with the install of Firefox (e.g. 'mozilla-win-eol-esr115', 'MozillaOnline'). Null for ~75.6% of rows representing direct or unattributed installs (sampled 2026-06-02).
• mau — The number of monthly active users, corresponding to the count of clients that reported at least one ping in the previous 28 days from the submission date.
• submission_date — The date when the telemetry ping is received on the server side.
• wau — The number of weekly active users, corresponding to the count of clients that reported at least one ping in the previous 7 days from the submission date.
• activity_segment — Classification of the client's browsing activity level during the reporting period. Values include 'infrequent_user', 'casual_user', 'regular_user', 'core_user', and 'other'.
• channel — The release channel through which Firefox is distributed to users (e.g. 'release', 'esr', 'beta', 'nightly', 'aurora').
• country — ISO 3166-1 alpha-2 country code of the client, as determined by IP geolocation at ping ingestion.
• distribution_id — The distribution identifier associated with the Firefox install, identifying the partner or distribution channel (e.g. 'canonical-002', 'mozilla-win-eol-esr115'). NULL for standard Mozilla builds.
• os — The normalized name of the operating system running at the client (e.g. 'Windows', 'Mac', 'Linux').
• submission_date — The date when the telemetry ping is received on the server side.
• activity_segment — Classification of users based on their browsing activity. E.g., infrequent, casual, regular.
• campaign — The attribution campaign (UTM campaign) for the Firefox installation; null when the client is not attributed (sampled 2026-06-02).
• channel — The normalized channel the application is being distributed on.
• content — The attribution content (UTM content) for the Firefox installation; null when the client is not attributed (sampled 2026-06-02).
• country — Name of the country in which the activity took place, as determined by the IP geolocation.
• dau — The number of daily active users, corresponding to the count of clients that reported at least one ping on the submission_date and qualify as active. Null for dimension slices with no activity on that day (sampled 2026-06-02).
• distribution_id — The distribution id associated with the install of Firefox.
• mau — The number of monthly active users, corresponding to the count of clients that reported at least one ping in the previous 28 days and qualify as active. Null for dimension slices with no activity in the window (sampled 2026-06-02).
• medium — The attribution medium (UTM medium) for the Firefox installation; null when the client is not attributed (sampled 2026-06-02).
• os — The normalized name of the operating system running at the client. Observed values include Windows, Mac, Linux, and Other (sampled 2026-06-02).
• source — The attribution source (UTM source) for the Firefox installation; null when the client is not attributed (sampled 2026-06-02).
• submission_date — The date when the telemetry ping is received on the server side.
• wau — The number of weekly active users, corresponding to the count of clients that reported at least one ping in the previous 7 days and qualify as active. Null for dimension slices with no activity in the window (sampled 2026-06-02).
• app_build_id — The build ID of the application (a date-time stamp string identifying the specific build, e.g. 20231001120000).
• app_display_version — The user-visible version string of the Firefox application as displayed in the UI (e.g. 118.0.2).
• app_name — The name of the browser application (e.g. Firefox).
• app_version — The version string of the Firefox application (e.g. 118.0).
• attribution_experiment — The attribution experiment key associated with the Firefox installation, used to track A/B tests or experiments that influenced the install.
• attribution_variation — The attribution variation key associated with the Firefox installation, identifying the specific variant within an attribution experiment.
• channel — The release channel of the application as reported by the client (e.g. release, beta, nightly).
• client_id — A unique identifier (UUID) for the client.
• country — Name of the country in which the activity took place, as determined by IP geolocation.
• distribution_id — The distribution ID associated with the Firefox install, identifying the partner or channel through which Firefox was distributed.
• document_id — The document ID specified in the URI when the client sent this message.
• fxa_configured — Boolean indicating whether a Firefox Accounts (FxA) account was configured (signed in) on this client during this session.
• is_default_browser — True if Firefox is configured as the default browser on the client's operating system; false otherwise.
• locale — The locale of the Firefox application interface (e.g. en-US, fr, de), reflecting the user's language preference.
• normalized_channel — The normalized channel the application is being distributed on.
• normalized_os_version — The operating system version normalized to a consistent format at ingestion (e.g. "10.0" for Windows, "25.3.0" for macOS). Windows 10 and Windows 11 both show "10.0"; use windows_build_number >= 22000 to identify Windows 11.
• os — The name of the operating system running on the client (e.g. Windows_NT, Darwin, Linux).
• os_version — The operating system version running at the client prior to normalization (e.g. "10.0" for Windows, "25.3.0" for macOS).
• sample_id — A number, 0–99, that samples by client_id and allows filtering data for analysis. It is a pipeline-generated artifact that should match between pings.
• submission_date — The date when the telemetry ping is received on the server side.
• channel — The normalized release channel of the Firefox build (e.g. 'release', 'beta', 'nightly').
• submission_date — The date when the telemetry ping is received on the server side.
• channel — The Firefox release channel (e.g., 'release', 'beta', 'nightly') for which the probe count data was extracted.
• os — The normalized operating system name for which this probe count row applies.
• version — The Firefox major version number for which this probe count row applies.
• app_build_id — The build identifier of the Firefox Beta application in YYYYMMDDHHMMSS format; '*' represents an aggregation across all build IDs.
• app_version — The major version number of the Firefox Beta application (e.g. 146, 147, 148).
• os — The operating system of the client (e.g. 'Windows', 'Mac', 'Linux'); '*' represents an aggregation across all operating systems.
• app_build_id — The build identifier of the Firefox Nightly application in YYYYMMDDHHMMSS format; '*' represents an aggregation across all build IDs.
• app_version — The major version number of the Firefox Nightly application (e.g. 147, 148, 149).
• os — The operating system of the client (e.g. 'Windows', 'Mac', 'Linux'); '*' represents an aggregation across all operating systems.
• app_build_id — The build identifier of the Firefox Release application in YYYYMMDDHHMMSS format; '*' represents an aggregation across all build IDs.
• app_version — The major version number of the Firefox Release application (e.g. 145, 146, 147).
• os — The operating system of the client (e.g. 'Windows', 'Mac', 'Linux'); '*' represents an aggregation across all operating systems.
• app_build_id — The build identifier of the Firefox application in YYYYMMDDHHMMSS format; '*' represents an aggregation across all build IDs.
• app_version — The major version number of the Firefox application.
• os — The operating system of the client (e.g. 'Windows', 'Mac', 'Linux'); '*' represents an aggregation across all operating systems.
• app_build_id — The build identifier of the Firefox application in YYYYMMDDHHMMSS format; '*' represents an aggregation across all build IDs.
• app_version — The major version number of the Firefox application; 999 is used as a sentinel for cross-version rollups.
• channel — The normalized Firefox release channel (e.g. 'release', 'beta', 'nightly').
• os — The operating system of the client (e.g. 'Windows', 'Mac', 'Linux', 'Other'); '*' represents an aggregation across all operating systems. NULL when this rollup dimension is not applicable.
• app_build_id — The build identifier of the Firefox application in YYYYMMDDHHMMSS format; '*' represents an aggregation across all build IDs.
• app_version — The major version number of the Firefox application; 999 is a sentinel for cross-version rollups. NULL for approximately 41% of rows where version information is not available.
• os — The operating system of the client (e.g. 'Windows', 'Mac', 'Linux', 'Other'); '*' represents an aggregation across all operating systems.
• app_build_id — The build identifier of the Firefox application in YYYYMMDDHHMMSS format; NULL (approximately 4% of rows) represents an aggregation across all build IDs.
• app_version — The major version number of the Firefox application; 999 is a sentinel for cross-version rollups. NULL for approximately 41% of rows where version information is not available.
• channel — The normalized Firefox release channel (e.g. 'nightly', 'release', 'beta'); NULL for approximately 0.6% of rows where the channel cannot be determined.
• os — The operating system of the client (e.g. 'Windows', 'Mac', 'Linux', 'Other'); NULL (approximately 18% of rows) represents an aggregation across all operating systems that maps to '*' in the extract table.
• channel — The normalized release channel of the Firefox build on the client (e.g. 'release', 'beta', 'nightly').
• os — The normalized name of the operating system running at the client (e.g. 'Windows', 'Mac', 'Linux').
• submission_date — The date when the telemetry ping is received on the server side.
• app_build_id — The build identifier of the Firefox application (YYYYMMDDHHMMSS format). Null when data is aggregated across all builds for the version.
• channel — The Firefox release channel, e.g. 'nightly', 'beta', or 'release'. Used to segment GLAM histogram percentile data by distribution channel.
• os — The operating system of the clients contributing to this row. One of 'Windows', 'Mac', 'Linux', 'Other', or null when aggregated across all OS values (sampled 2026-06-02).
• submission_date — The date for which the metric value (observed or forecast) applies.
• channel — The Firefox release channel. One of 'release', 'beta', or 'nightly', representing the three primary distribution channels tracked in this table.
• channel — The Firefox release channel. One of 'release', 'beta', 'nightly', or 'esr', representing the four distribution channels tracked from the Mozilla product-details API.
• submission_date — The date to which this forecast cache entry applies.
• channel — The Firefox release channel (e.g., 'release', 'beta', 'nightly', 'esr') for the clients in this cohort.
• country — Two-letter ISO 3166-1 alpha-2 country code of the client's location, as determined by IP geolocation.
• is_default_browser — True if Firefox is set as the operating system's default browser on the client; false otherwise.
• locale — The browser locale (e.g., 'en-US', 'fr', 'de') of the clients in this cohort.
• normalized_os — The normalized name of the operating system (e.g., 'Windows', 'Mac', 'Linux') running on the client.
• additional_properties — A JSON string containing any payload properties present in the raw ping that are not represented as explicit columns in the schema.
• client_id — A UUID uniquely identifying the Firefox client.
• document_id — The document ID specified in the URI when the client sent this ping, used for deduplication.
• normalized_app_name — The normalized application name; set to 'Other' if the app name was not recognized during ingestion.
• normalized_channel — The normalized release channel; set to 'Other' if the channel was not recognized during ingestion.
• normalized_country_code — An ISO 3166-1 alpha-2 country code derived from IP geolocation at ingestion time.
• normalized_os — The normalized operating system name; set to 'Other' if the OS was not recognized during ingestion.
• normalized_os_version — The operating system version normalized to a consistent format at ingestion.
• profile_group_id — A UUID uniquely identifying the profile group on a single device, enabling user-oriented correlation of data across profiles.
• sample_id — A stable hash of client_id modulo 100 (0–99) used to partition data; this table contains only rows where sample_id = 0 (a 1% sample).
• submission_timestamp — Timestamp when the ingestion edge server accepted this ping.
• app_name — The name of the browser application (e.g., 'Firefox').
• is_default_browser — True if Firefox is set as the operating system's default browser; false otherwise.
• os_version — The operating system version string reported by the client (e.g., '10.0' for Windows, '5.1' for Windows XP).
• additional_properties — A JSON string containing any payload properties present in the raw ping that are not represented as explicit columns in the schema.
• client_id — A UUID uniquely identifying the Firefox client.
• document_id — The document ID specified in the URI when the client sent this ping, used for deduplication.
• normalized_app_name — The normalized application name; set to 'Other' if the app name was not recognized during ingestion.
• normalized_channel — The normalized release channel; filtered to 'nightly' for all rows in this table.
• normalized_country_code — An ISO 3166-1 alpha-2 country code derived from IP geolocation at ingestion time.
• normalized_os — The normalized operating system name; set to 'Other' if the OS was not recognized during ingestion.
• normalized_os_version — The operating system version normalized to a consistent format at ingestion.
• profile_group_id — A UUID uniquely identifying the profile group on a single device, enabling user-oriented correlation of data across profiles.
• sample_id — A stable hash of client_id modulo 100 (0–99), used to partition data for analysis.
• submission_timestamp — Timestamp when the ingestion edge server accepted this ping.
• additional_properties — A JSON string containing any payload properties present in the raw ping that are not represented as explicit columns in the schema.
• client_id — A UUID uniquely identifying the Firefox client.
• document_id — The document ID specified in the URI when the client sent this ping, used for deduplication.
• normalized_app_name — The normalized application name; set to 'Other' if the app name was not recognized during ingestion.
• normalized_channel — The normalized release channel; set to 'Other' if the channel was not recognized during ingestion.
• normalized_country_code — An ISO 3166-1 alpha-2 country code derived from IP geolocation at ingestion time.
• normalized_os — The normalized operating system name; set to 'Other' if the OS was not recognized during ingestion.
• normalized_os_version — The operating system version normalized to a consistent format at ingestion.
• profile_group_id — A UUID uniquely identifying the profile group on a single device, enabling user-oriented correlation of data across profiles.
• sample_id — A stable hash of client_id modulo 100 (0–99) used to partition data; this table contains only rows where sample_id = 0 (a 1% sample).
• submission_timestamp — Timestamp when the ingestion edge server accepted this ping.
• additional_properties — A JSON string containing any payload properties present in the raw ping that are not represented as explicit columns in the schema.
• client_id — A UUID uniquely identifying the Firefox client.
• document_id — The document ID specified in the URI when the client sent this ping, used for deduplication.
• normalized_app_name — The normalized application name; set to 'Other' if the app name was not recognized during ingestion.
• normalized_channel — The normalized release channel; set to 'Other' if the channel was not recognized during ingestion.
• normalized_country_code — An ISO 3166-1 alpha-2 country code derived from IP geolocation at ingestion time.
• normalized_os — The normalized operating system name; set to 'Other' if the OS was not recognized during ingestion.
• normalized_os_version — The operating system version normalized to a consistent format at ingestion.
• sample_id — A stable hash of client_id modulo 100 (0–99) used to partition data; this table contains only rows where sample_id = 0 (a 1% sample).
• submission_timestamp — Timestamp when the ingestion edge server accepted this ping.
• normalized_os_version — The user-visible version of the operating system (e.g. '10.0' for Windows 10, '6.8' for Linux kernel 6.8). Derived from the Glean os_version metric.
• activity_segment — Classification of users based on their browsing activity. E.g., infrequent, casual, regular.
• channel — The normalized channel the application is being distributed on (e.g. 'release', 'esr', 'beta', 'nightly').
• country_code — Code of the country in which the activity took place, as determined by the IP geolocation. Unknown or NULL values are normally stored as '??'.
• os — The name of the operating system for clients in this aggregate row (e.g. 'Windows', 'Mac', 'Linux').
• os_version — The user-visible version of the operating system for clients in this aggregate row (e.g. '10.0' for Windows 10).
• submission_date — The date when the telemetry ping is received on the server side.
• activity_segment — Classification of users based on their browsing activity. E.g., infrequent, casual, regular.
• channel — The normalized channel the application is being distributed on.
• country_code — Code of the country in which the activity took place, as determined by the IP geolocation. Unknown or NULL values are normally stored as '??'.
• os — The name of the operating system running on the client for this visit (e.g. 'Windows', 'Mac', 'Linux').
• os_version — The user-visible version of the operating system (e.g. '10.0' for Windows 10, '25.5.0' for Android). Derived from the Glean os_version metric.
• activity_segment — Classification of users based on their browsing activity. E.g., infrequent, casual, regular.
• normalized_os_version — The user-visible version of the operating system (e.g. '10.0' for Windows 10). Derived from the Glean os_version metric.
• mau — Monthly Active Users — count of unique Firefox Desktop clients active within the past 28 days.
• submission_date — The date when the telemetry ping is received on the server side.
• mau — Monthly Active Users — count of unique Firefox Desktop clients active within the past 28 days.
• submission_date — The date when the telemetry ping is received on the server side.
• submission_date — The date when the telemetry ping is received on the server side.
• app_build_id — The build ID of the Firefox application (e.g., '20240509170740'). Null for rows aggregated across all builds.
• app_version — The major Firefox version number of the clients contributing to this row.
• channel — The normalized Firefox release channel (e.g., 'release', 'nightly', 'beta').
• os — The normalized operating system for the aggregated clients. Null for rows that aggregate across all OS values.
• adjust_network — The name of the Adjust Network that sourced the installation. Populated only for mobile clients (~14% non-null).
• app_name — The name of the browser application (e.g., 'Firefox Desktop', 'Fenix', 'Firefox iOS').
• attribution_medium — The attribution medium (similar to UTM medium) associated with the client's install. Null for ~28% of rows.
• attribution_source — The attribution source (similar to UTM source) associated with the client's install. Null for ~28% of rows.
• dau — The number of daily active users for the dimension combination on the submission_date.
• country — Code of the country in which the activity took place, as determined by IP geolocation. The compressed variant retains only the top ~15 countries.
• os — The normalized name of the operating system (compressed to top values: 'Windows_NT', 'Darwin', 'Linux', 'Other').
• app_name — The name of the browser application. For this desktop-specific table always 'Firefox'.
• os_version — The version string of the operating system (e.g., '10.0' for Windows 10, '24.6.0' for macOS).
• app_name — The name of the application. Null for this FxA table (not application-specific).
• app_version — The Firefox Account backend version string.
• channel — The normalized release channel. Null for Firefox Account activity (not channel-specific).
• country — Code of the country in which the activity took place, as determined by IP geolocation.
• locale — Set of language- and/or country-based preferences for the Firefox Account user interface.
• os — The normalized name of the operating system (e.g., 'Android', 'Windows', 'Mac OS X', 'Linux', 'iOS').
• os_version — The version string of the operating system (e.g., '10' for Windows 10, '16' for Android 16).
• submission_date — The date when the telemetry ping is received on the server side.
• app_name — The name of the browser application (e.g., 'Firefox', 'Fenix', 'Firefox iOS').
• os_version — The version string of the operating system (e.g., '10.0' for Windows 10).
• channel — The normalized release channel (e.g., 'release', 'beta', 'nightly').
• country — Code of the country in which the activity took place, as determined by IP geolocation. The compressed variant retains only the top ~15 countries.
• locale — Set of language- and/or country-based preferences for the user interface (compressed to top values).
• os — The normalized name of the operating system. For this non-desktop table always 'Other'.
• submission_date — The date when the telemetry ping is received on the server side.
• app_name — The name of the non-desktop browser application (e.g., 'Fenix', 'Firefox iOS', 'Firefox Non-desktop').
• app_version — User visible version string for the non-desktop browser.
• channel — The normalized release channel (e.g., 'release', 'beta', 'nightly').
• country — Code of the country in which the activity took place, as determined by IP geolocation.
• locale — Set of language- and/or country-based preferences for the user interface.
• os — The normalized name of the operating system (e.g., 'Android', 'iOS').
• os_version — The version string of the operating system (e.g., '16', '13').
• submission_date — The date when the telemetry ping is received on the server side.
• build_id — The build identifier of the product that crashed (e.g., '20260520211922').
• normalized_os_version — The normalized version string of the operating system (e.g., '10.0' for Windows 10).
• app_build_id — The build ID of the Firefox application (e.g., '20191202093317').
• app_version — The major Firefox version number for this row (e.g., 72, 73).
• channel — The normalized Firefox release channel (e.g., 'release', 'beta', 'nightly').
• client_id — A unique identifier (UUID) for the client.
• os — The normalized name of the operating system running at the client (e.g., 'Windows', 'Mac', 'Linux').
• sample_id — A number, 0-99, that samples by client_id and allows filtering data for analysis. It is a pipeline-generated artifact that should match between pings.
• fields.client_id — A unique identifier (UUID) for the client, nested inside the fields struct.
• submission_date — The date when the telemetry ping is received on the server side.
• client_id — A unique identifier (UUID) for the client.
• submission_timestamp — Timestamp when the ping is received on the server side.
• submission_date — The date when the telemetry ping is received on the server side.
• attribution_campaign — The marketing campaign identifier that led to the Firefox install, e.g. 'SET_DEFAULT_BROWSER', 'non-fx-button'. Desktop only; null for mobile (sampled 2026-06-02).
• attribution_content — The attribution content parameter from the Firefox installer, identifying the specific link or creative within a campaign that led to the download. Desktop only; null for mobile (sampled 2026-06-02).
• attribution_experiment — A funnel experiment parameter from the Firefox installer attribution, used to track download-funnel experiments. Desktop only; null for mobile (sampled 2026-06-02).
• attribution_medium — The marketing medium that drove the Firefox install, e.g. 'referral', 'paidsearch', 'email'. Desktop only; null for mobile (sampled 2026-06-02).
• attribution_source — The referring partner domain or source that directed the user to download Firefox, e.g. 'www.google.com', 'www.bing.com'. Desktop only; null for mobile (sampled 2026-06-02).
• attribution_variation — The variation arm of the installer funnel experiment, e.g. 'treatment' or 'control'. Desktop only; null for mobile (sampled 2026-06-02).
• city — The city associated with the client's IP address as determined by IP geolocation. Null or '??' when city cannot be determined (sampled 2026-06-02).
• normalized_os_version — The normalized version string of the operating system running on the client, e.g. '10.0', '6.1', '16'. Derived from the telemetry environment.
• os_version_patch — The patch (third) component of the OS version string. For example, for '100.9.11', the patch is 11. Defaults to 0 when not present or parseable.
• app_version — User visible version string (e.g. '151.0.1') for the Firefox Desktop browser on the submission date.
• client_id — A unique identifier (UUID) for the client.
• country — An ISO 3166-1 alpha-2 country code identifying the country of the client based on IP geolocation. Defaults to '??' when unknown.
• experiments — An array of key-value pairs listing the Nimbus experiments and rollouts the client was enrolled in on the submission date, where key is the experiment slug and value is the branch name (e.g. 'control', 'treatment-a').
• locale — Set of language- and/or country-based preferences for the browser user interface, e.g. 'en-US', 'de', 'fr'.
• normalized_channel — The normalized channel the application is being distributed on, e.g. 'release', 'esr', 'beta', 'nightly'.

Contradictions Found

None

Skipped

• 0 fields excluded (undocumented tier — out of scope)
• 2 empty or undeployed tables
• 0 fields already described (unchanged)

Checklist

• Descriptions reviewed for accuracy
• Global.yaml candidates verified as truly cross-dataset
• Contradictions investigated before merging

[github-actions]

Integration report for "chore(schema): add field descriptions for telemetry_derived"

sql.diff

Click to expand!

diff -bur --no-dereference --new-file /tmp/workspace/main-generated-sql/sql/moz-fx-data-shared-prod/telemetry_derived/active_users_aggregates_v1/schema.yaml /tmp/workspace/generated-sql/sql/moz-fx-data-shared-prod/telemetry_derived/active_users_aggregates_v1/schema.yaml
--- /tmp/workspace/main-generated-sql/sql/moz-fx-data-shared-prod/telemetry_derived/active_users_aggregates_v1/schema.yaml	2026-06-08 14:05:29.657610516 +0000
+++ /tmp/workspace/generated-sql/sql/moz-fx-data-shared-prod/telemetry_derived/active_users_aggregates_v1/schema.yaml	2026-06-08 14:05:24.821612743 +0000
@@ -108,6 +108,7 @@
 - mode: NULLABLE
   name: first_seen_year
   type: INTEGER
+  description: The calendar year in which the client's profile was first seen by Mozilla's telemetry pipeline.
 - mode: NULLABLE
   name: attributed
   type: BOOLEAN
diff -bur --no-dereference --new-file /tmp/workspace/main-generated-sql/sql/moz-fx-data-shared-prod/telemetry_derived/clients_daily_joined_v1/schema.yaml /tmp/workspace/generated-sql/sql/moz-fx-data-shared-prod/telemetry_derived/clients_daily_joined_v1/schema.yaml
--- /tmp/workspace/main-generated-sql/sql/moz-fx-data-shared-prod/telemetry_derived/clients_daily_joined_v1/schema.yaml	2026-06-08 14:05:29.662610522 +0000
+++ /tmp/workspace/generated-sql/sql/moz-fx-data-shared-prod/telemetry_derived/clients_daily_joined_v1/schema.yaml	2026-06-08 14:05:24.828610613 +0000
@@ -1159,6 +1159,7 @@
   mode: REPEATED
   name: scalar_parent_browser_ui_interaction_preferences_pane_home_sum
   type: RECORD
+  description: Keyed count of user interactions in the Firefox Preferences Home panel, keyed by the specific UI element interacted with.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1169,6 +1170,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_autofill_sum
   type: RECORD
+  description: Keyed count of URL bar autofill result selections, keyed by the autofill source (e.g., 'origin', 'url', 'adaptive').
 - fields:
   - mode: NULLABLE
     name: key
@@ -1179,6 +1181,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_autofill_about_sum
   type: RECORD
+  description: Keyed count of URL bar selections of autofill suggestions for about; pages, keyed by the specific page.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1189,6 +1192,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_autofill_adaptive_sum
   type: RECORD
+  description: Keyed count of URL bar selections of adaptive autofill suggestions (learned from the user's history), keyed by source.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1199,6 +1203,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_autofill_origin_sum
   type: RECORD
+  description: Keyed count of URL bar selections of origin-based autofill suggestions, keyed by the domain origin.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1209,6 +1214,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_autofill_other_sum
   type: RECORD
+  description: Keyed count of URL bar selections of autofill suggestions of type 'other', keyed by source.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1219,6 +1225,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_autofill_preloaded_sum
   type: RECORD
+  description: Keyed count of URL bar selections of autofill suggestions from the preloaded top sites list, keyed by site.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1229,6 +1236,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_autofill_url_sum
   type: RECORD
+  description: Keyed count of URL bar selections of full-URL autofill suggestions, keyed by source.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1239,6 +1247,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_bookmark_sum
   type: RECORD
+  description: Keyed count of URL bar result selections of bookmarks, keyed by the search entry point (e.g., 'urlbar', 'searchbar').
 - fields:
   - mode: NULLABLE
     name: key
@@ -1249,6 +1258,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_dynamic_sum
   type: RECORD
+  description: Keyed count of URL bar selections of dynamic result types, keyed by result type.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1259,6 +1269,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_extension_sum
   type: RECORD
+  description: Keyed count of URL bar result selections provided by a browser extension, keyed by extension ID.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1269,6 +1280,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_formhistory_sum
   type: RECORD
+  description: Keyed count of URL bar selections of form history suggestions, keyed by field name.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1279,6 +1291,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_history_sum
   type: RECORD
+  description: Keyed count of URL bar selections of browsing history results, keyed by the entry point.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1289,6 +1302,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_keyword_sum
   type: RECORD
+  description: Keyed count of URL bar selections of keyword (search engine shortcut) results, keyed by keyword.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1299,6 +1313,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_remotetab_sum
   type: RECORD
+  description: Keyed count of URL bar selections of remote tabs (tabs from synced devices), keyed by device type.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1309,6 +1324,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_searchengine_sum
   type: RECORD
+  description: Keyed count of URL bar selections that launched a search via a specific engine, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1319,6 +1335,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_searchsuggestion_sum
   type: RECORD
+  description: Keyed count of URL bar selections of search suggestions, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1329,6 +1346,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_switchtab_sum
   type: RECORD
+  description: Keyed count of URL bar selections that switched to an already-open tab, keyed by entry point.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1339,6 +1357,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_tabtosearch_sum
   type: RECORD
+  description: Keyed count of URL bar result selections for tab-to-search (engine from site), keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1349,6 +1368,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_tip_sum
   type: RECORD
+  description: Keyed count of URL bar selections of tip results (e.g., redirect tips), keyed by tip type.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1359,6 +1379,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_topsite_sum
   type: RECORD
+  description: Keyed count of URL bar selections of Top Sites results, keyed by site identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1369,6 +1390,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_unknown_sum
   type: RECORD
+  description: Keyed count of URL bar selections of result types that could not be categorized, keyed by source.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1379,6 +1401,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_visiturl_sum
   type: RECORD
+  description: Keyed count of URL bar selections where the user navigated directly to a typed URL, keyed by entry point.
 - mode: NULLABLE
   name: default_private_search_engine
   type: STRING
@@ -1426,6 +1449,7 @@
   mode: REPEATED
   name: search_with_ads
   type: RECORD
+  description: Keyed count of search result page impressions that contained ads, keyed by search engine and access point (e.g., 'google-b-d:urlbar').
 - fields:
   - mode: NULLABLE
     name: key
@@ -1436,6 +1460,7 @@
   mode: REPEATED
   name: ad_clicks
   type: RECORD
+  description: Keyed count of ad clicks on search result pages, keyed by search engine and access point (e.g., 'google-b-d:urlbar').
 - fields:
   - mode: NULLABLE
     name: key
@@ -1446,6 +1471,7 @@
   mode: REPEATED
   name: search_content_urlbar_sum
   type: RECORD
+  description: Keyed count of searches initiated from the URL bar, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1456,6 +1482,7 @@
   mode: REPEATED
   name: search_content_urlbar_handoff_sum
   type: RECORD
+  description: Keyed count of searches initiated via URL bar handoff from the new tab page, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1466,6 +1493,7 @@
   mode: REPEATED
   name: search_content_urlbar_persisted_sum
   type: RECORD
+  description: Keyed count of searches where the URL bar retained the search term after submission, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1476,6 +1504,7 @@
   mode: REPEATED
   name: search_content_urlbar_searchmode_sum
   type: RECORD
+  description: Keyed count of searches performed while the URL bar was in search mode, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1486,6 +1515,7 @@
   mode: REPEATED
   name: search_content_contextmenu_sum
   type: RECORD
+  description: Keyed count of searches initiated via the right-click context menu, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1496,6 +1526,7 @@
   mode: REPEATED
   name: search_content_about_home_sum
   type: RECORD
+  description: Keyed count of searches from the about:home new tab page, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1506,6 +1537,7 @@
   mode: REPEATED
   name: search_content_about_newtab_sum
   type: RECORD
+  description: Keyed count of searches from the new tab page, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1516,6 +1548,7 @@
   mode: REPEATED
   name: search_content_searchbar_sum
   type: RECORD
+  description: Keyed count of searches from the dedicated search bar, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1526,6 +1559,7 @@
   mode: REPEATED
   name: search_content_system_sum
   type: RECORD
+  description: Keyed count of system-initiated searches (OS-level integration), keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1536,6 +1570,7 @@
   mode: REPEATED
   name: search_content_webextension_sum
   type: RECORD
+  description: Keyed count of searches initiated via a browser extension, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1546,6 +1581,7 @@
   mode: REPEATED
   name: search_content_tabhistory_sum
   type: RECORD
+  description: Keyed count of searches initiated via browser tab history navigation, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1556,6 +1592,7 @@
   mode: REPEATED
   name: search_content_reload_sum
   type: RECORD
+  description: Keyed count of searches triggered by a page reload action, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1566,6 +1603,7 @@
   mode: REPEATED
   name: search_content_unknown_sum
   type: RECORD
+  description: Keyed count of searches from unclassified entry points, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1576,6 +1614,7 @@
   mode: REPEATED
   name: search_withads_urlbar_sum
   type: RECORD
+  description: Keyed count of search result pages with ads from URL bar searches, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1586,6 +1625,7 @@
   mode: REPEATED
   name: search_withads_urlbar_handoff_sum
   type: RECORD
+  description: Keyed count of search result pages with ads from URL bar handoff searches, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1596,6 +1636,7 @@
   mode: REPEATED
   name: search_withads_urlbar_persisted_sum
   type: RECORD
+  description: Keyed count of search result pages with ads where the URL bar retained the search term, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1606,6 +1647,7 @@
   mode: REPEATED
   name: search_withads_urlbar_searchmode_sum
   type: RECORD
+  description: Keyed count of search result pages with ads from URL bar search-mode searches, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1616,6 +1658,7 @@
   mode: REPEATED
   name: search_withads_contextmenu_sum
   type: RECORD
+  description: Keyed count of search result pages with ads from context menu searches, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1626,6 +1669,7 @@
   mode: REPEATED
   name: search_withads_about_home_sum
   type: RECORD
+  description: Keyed count of search result pages with ads from about:home searches, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1636,6 +1680,7 @@
   mode: REPEATED
   name: search_withads_about_newtab_sum
   type: RECORD
+  description: Keyed count of search result pages with ads from new tab page searches, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1646,6 +1691,7 @@
   mode: REPEATED
   name: search_withads_searchbar_sum
   type: RECORD
+  description: Keyed count of search result pages with ads from the search bar, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1656,6 +1702,7 @@
   mode: REPEATED
   name: search_withads_system_sum
   type: RECORD
+  description: Keyed count of search result pages with ads from system-initiated searches, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1666,6 +1713,7 @@
   mode: REPEATED
   name: search_withads_webextension_sum
   type: RECORD
+  description: Keyed count of search result pages with ads from extension-initiated searches, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1676,6 +1724,7 @@
   mode: REPEATED
   name: search_withads_tabhistory_sum
   type: RECORD
+  description: Keyed count of search result pages with ads from tab history navigation, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1686,6 +1735,7 @@
   mode: REPEATED
   name: search_withads_reload_sum
   type: RECORD
+  description: Keyed count of search result pages with ads from page reload, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1696,6 +1746,7 @@
   mode: REPEATED
   name: search_withads_unknown_sum
   type: RECORD
+  description: Keyed count of search result pages with ads from unclassified entry points, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1706,6 +1757,7 @@
   mode: REPEATED
   name: search_adclicks_urlbar_sum
   type: RECORD
+  description: Keyed count of ad clicks on search result pages from URL bar searches, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1716,6 +1768,7 @@
   mode: REPEATED
   name: search_adclicks_urlbar_handoff_sum
   type: RECORD
+  description: Keyed count of ad clicks on search result pages from URL bar handoff searches, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1726,6 +1779,7 @@
   mode: REPEATED
   name: search_adclicks_urlbar_persisted_sum
   type: RECORD
+  description: Keyed count of ad clicks on search result pages where the URL bar retained the search term, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1736,6 +1790,7 @@
   mode: REPEATED
   name: search_adclicks_urlbar_searchmode_sum
   type: RECORD
+  description: Keyed count of ad clicks on search result pages from URL bar search-mode searches, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1746,6 +1801,7 @@
   mode: REPEATED
   name: search_adclicks_contextmenu_sum
   type: RECORD
+  description: Keyed count of ad clicks from context menu searches, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1756,6 +1812,7 @@
   mode: REPEATED
   name: search_adclicks_about_home_sum
   type: RECORD
+  description: Keyed count of ad clicks from about:home searches, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1766,6 +1823,7 @@
   mode: REPEATED
   name: search_adclicks_about_newtab_sum
   type: RECORD
+  description: Keyed count of ad clicks from new tab page searches, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1776,6 +1834,7 @@
   mode: REPEATED
   name: search_adclicks_searchbar_sum
   type: RECORD
+  description: Keyed count of ad clicks from the search bar, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1786,6 +1845,7 @@
   mode: REPEATED
   name: search_adclicks_system_sum
   type: RECORD
+  description: Keyed count of ad clicks from system-initiated searches, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1796,6 +1856,7 @@
   mode: REPEATED
   name: search_adclicks_webextension_sum
   type: RECORD
+  description: Keyed count of ad clicks from extension-initiated searches, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1806,6 +1867,7 @@
   mode: REPEATED
   name: search_adclicks_tabhistory_sum
   type: RECORD
+  description: Keyed count of ad clicks from tab history navigation searches, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1816,6 +1878,7 @@
   mode: REPEATED
   name: search_adclicks_reload_sum
   type: RECORD
+  description: Keyed count of ad clicks from page reload searches, keyed by search engine identifier.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1826,6 +1889,7 @@
   mode: REPEATED
   name: search_adclicks_unknown_sum
   type: RECORD
+  description: Keyed count of ad clicks from unclassified search entry points, keyed by search engine identifier.
 - mode: NULLABLE
   name: update_background
   type: BOOLEAN
@@ -1889,6 +1953,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_click_sum
   type: RECORD
+  description: Keyed count of Firefox Suggest (Quicksuggest) result clicks, keyed by suggestion type and source.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1899,6 +1964,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_impression_sum
   type: RECORD
+  description: Keyed count of Firefox Suggest result impressions (times a result was shown), keyed by suggestion type and source.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1909,6 +1975,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_help_sum
   type: RECORD
+  description: Keyed count of times the 'Learn More' help link was clicked on a Firefox Suggest result, keyed by suggestion type.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1919,6 +1986,7 @@
   mode: REPEATED
   name: contextual_services_topsites_click_sum
   type: RECORD
+  description: Keyed count of Top Sites tile clicks in the Firefox new tab page, keyed by tile source and position.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1929,6 +1997,7 @@
   mode: REPEATED
   name: contextual_services_topsites_impression_sum
   type: RECORD
+  description: Keyed count of Top Sites tile impressions in the Firefox new tab page, keyed by tile source and position.
 - mode: NULLABLE
   name: user_pref_browser_urlbar_suggest_quicksuggest_nonsponsored
   type: STRING
@@ -1955,6 +2024,7 @@
   mode: REPEATED
   name: a11y_theme
   type: RECORD
+  description: Keyed boolean indicators of Windows accessibility theme settings active for this client, keyed by theme attribute name.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1965,6 +2035,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_help_nonsponsored_bestmatch_sum
   type: RECORD
+  description: Keyed count of help link clicks on non-sponsored Best Match Firefox Suggest results, keyed by suggestion type.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1975,6 +2046,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_help_sponsored_bestmatch_sum
   type: RECORD
+  description: Keyed count of help link clicks on sponsored Best Match Firefox Suggest results, keyed by suggestion type.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1985,6 +2057,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_block_nonsponsored_sum
   type: RECORD
+  description: Keyed count of times a non-sponsored Firefox Suggest result was dismissed/blocked, keyed by suggestion type.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1995,6 +2068,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_block_sponsored_sum
   type: RECORD
+  description: Keyed count of times a sponsored Firefox Suggest result was dismissed/blocked, keyed by suggestion type.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2005,6 +2079,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_block_sponsored_bestmatch_sum
   type: RECORD
+  description: Keyed count of times a sponsored Best Match Firefox Suggest result was blocked, keyed by suggestion type.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2015,6 +2090,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_block_nonsponsored_bestmatch_sum
   type: RECORD
+  description: Keyed count of times a non-sponsored Best Match Firefox Suggest result was blocked, keyed by suggestion type.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2025,6 +2101,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_click_sponsored_bestmatch_sum
   type: RECORD
+  description: Keyed count of clicks on sponsored Best Match Firefox Suggest results, keyed by suggestion type.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2035,6 +2112,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_click_nonsponsored_bestmatch_sum
   type: RECORD
+  description: Keyed count of clicks on non-sponsored Best Match Firefox Suggest results, keyed by suggestion type.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2045,6 +2123,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_impression_sponsored_bestmatch_sum
   type: RECORD
+  description: Keyed count of impressions of sponsored Best Match Firefox Suggest results, keyed by suggestion type.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2055,6 +2134,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_impression_nonsponsored_bestmatch_sum
   type: RECORD
+  description: Keyed count of impressions of non-sponsored Best Match Firefox Suggest results, keyed by suggestion type.
 - mode: NULLABLE
   name: user_pref_browser_urlbar_suggest_bestmatch
   type: STRING
@@ -2081,6 +2161,7 @@
   mode: REPEATED
   name: scalar_parent_browser_ui_interaction_content_context_sum
   type: RECORD
+  description: Keyed count of user interactions with the browser content area context menu, keyed by the menu item action.
 - mode: NULLABLE
   name: text_recognition_api_performance_sum
   type: INTEGER
@@ -2219,6 +2300,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_block_dynamic_wikipedia_sum
   type: RECORD
+  description: Keyed count of times a dynamic Wikipedia Firefox Suggest result was blocked, keyed by suggestion source.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2229,6 +2311,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_block_weather_sum
   type: RECORD
+  description: Keyed count of times a weather Firefox Suggest result was blocked, keyed by suggestion source.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2239,6 +2322,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_click_dynamic_wikipedia_sum
   type: RECORD
+  description: Keyed count of clicks on dynamic Wikipedia Firefox Suggest results, keyed by suggestion source.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2249,6 +2333,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_click_nonsponsored_sum
   type: RECORD
+  description: Keyed count of clicks on non-sponsored Firefox Suggest results, keyed by suggestion type.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2259,6 +2344,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_click_sponsored_sum
   type: RECORD
+  description: Keyed count of clicks on sponsored Firefox Suggest results, keyed by suggestion type.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2269,6 +2355,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_click_weather_sum
   type: RECORD
+  description: Keyed count of clicks on weather Firefox Suggest results, keyed by suggestion source.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2279,6 +2366,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_help_dynamic_wikipedia_sum
   type: RECORD
+  description: Keyed count of help link clicks on dynamic Wikipedia Firefox Suggest results, keyed by suggestion source.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2289,6 +2377,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_help_nonsponsored_sum
   type: RECORD
+  description: Keyed count of help link clicks on non-sponsored Firefox Suggest results, keyed by suggestion type.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2299,6 +2388,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_help_sponsored_sum
   type: RECORD
+  description: Keyed count of help link clicks on sponsored Firefox Suggest results, keyed by suggestion type.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2309,6 +2399,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_help_weather_sum
   type: RECORD
+  description: Keyed count of help link clicks on weather Firefox Suggest results, keyed by suggestion source.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2319,6 +2410,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_impression_dynamic_wikipedia_sum
   type: RECORD
+  description: Keyed count of impressions of dynamic Wikipedia Firefox Suggest results, keyed by suggestion source.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2329,6 +2421,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_impression_nonsponsored_sum
   type: RECORD
+  description: Keyed count of impressions of non-sponsored Firefox Suggest results, keyed by suggestion type.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2339,6 +2432,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_impression_sponsored_sum
   type: RECORD
+  description: Keyed count of impressions of sponsored Firefox Suggest results, keyed by suggestion type.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2349,6 +2443,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_impression_weather_sum
   type: RECORD
+  description: Keyed count of impressions of weather Firefox Suggest results, keyed by suggestion source.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2359,6 +2454,7 @@
   mode: REPEATED
   name: scalar_parent_sidebar_opened_sum
   type: RECORD
+  description: Keyed count of times Firefox Sidebar panels were opened, keyed by sidebar panel name (e.g., 'bookmarks', 'history').
 - fields:
   - mode: NULLABLE
     name: key
@@ -2369,6 +2465,7 @@
   mode: REPEATED
   name: scalar_parent_sidebar_search_sum
   type: RECORD
+  description: Keyed count of searches performed within Firefox Sidebar panels, keyed by panel name.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2379,6 +2476,7 @@
   mode: REPEATED
   name: scalar_parent_sidebar_link_sum
   type: RECORD
+  description: Keyed count of link activations within Firefox Sidebar panels, keyed by panel name.
 - name: places_previousday_visits_mean
   type: FLOAT
   mode: NULLABLE
@@ -2399,6 +2497,7 @@
   type: RECORD
   mode: REPEATED
   fields:
+  description: Keyed count of link activations within the Firefox Library panel, keyed by section (e.g., 'bookmarks', 'history').
   - name: key
     type: STRING
     mode: NULLABLE
@@ -2409,6 +2508,7 @@
   type: RECORD
   mode: REPEATED
   fields:
+  description: Keyed count of times the Firefox Library panel was opened, keyed by entry point (e.g., 'toolbar', 'menu').
   - name: key
     type: STRING
     mode: NULLABLE
@@ -2419,6 +2519,7 @@
   type: RECORD
   mode: REPEATED
   fields:
+  description: Keyed count of searches performed within the Firefox Library panel, keyed by section.
   - name: key
     type: STRING
     mode: NULLABLE
diff -bur --no-dereference --new-file /tmp/workspace/main-generated-sql/sql/moz-fx-data-shared-prod/telemetry_derived/clients_daily_v6/schema.yaml /tmp/workspace/generated-sql/sql/moz-fx-data-shared-prod/telemetry_derived/clients_daily_v6/schema.yaml
--- /tmp/workspace/main-generated-sql/sql/moz-fx-data-shared-prod/telemetry_derived/clients_daily_v6/schema.yaml	2026-06-08 14:05:29.662610522 +0000
+++ /tmp/workspace/generated-sql/sql/moz-fx-data-shared-prod/telemetry_derived/clients_daily_v6/schema.yaml	2026-06-08 14:05:24.828610613 +0000
@@ -1155,6 +1155,7 @@
   mode: REPEATED
   name: scalar_parent_browser_ui_interaction_preferences_pane_home_sum
   type: RECORD
+  description: Keyed count of user interactions in the Firefox Preferences Home panel, keyed by UI element.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1165,6 +1166,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_autofill_sum
   type: RECORD
+  description: Keyed count of URL bar autofill result selections, keyed by autofill source.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1175,6 +1177,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_autofill_about_sum
   type: RECORD
+  description: Keyed count of URL bar selections of autofill suggestions for about; pages.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1185,6 +1188,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_autofill_adaptive_sum
   type: RECORD
+  description: Keyed count of URL bar selections of adaptive (history-learned) autofill suggestions.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1195,6 +1199,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_autofill_origin_sum
   type: RECORD
+  description: Keyed count of URL bar selections of origin-based autofill suggestions.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1205,6 +1210,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_autofill_other_sum
   type: RECORD
+  description: Keyed count of URL bar selections of 'other' type autofill suggestions.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1215,6 +1221,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_autofill_preloaded_sum
   type: RECORD
+  description: Keyed count of URL bar selections of autofill suggestions from the preloaded top sites list.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1225,6 +1232,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_autofill_url_sum
   type: RECORD
+  description: Keyed count of URL bar selections of full-URL autofill suggestions.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1235,6 +1243,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_bookmark_sum
   type: RECORD
+  description: Keyed count of URL bar result selections of bookmarks, keyed by search entry point.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1245,6 +1254,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_dynamic_sum
   type: RECORD
+  description: Keyed count of URL bar selections of dynamic result types.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1255,6 +1265,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_extension_sum
   type: RECORD
+  description: Keyed count of URL bar results provided by a browser extension that were selected.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1265,6 +1276,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_formhistory_sum
   type: RECORD
+  description: Keyed count of URL bar selections of form history suggestions.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1275,6 +1287,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_history_sum
   type: RECORD
+  description: Keyed count of URL bar selections of browsing history results.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1285,6 +1298,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_keyword_sum
   type: RECORD
+  description: Keyed count of URL bar selections of keyword (search engine shortcut) results.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1295,6 +1309,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_remotetab_sum
   type: RECORD
+  description: Keyed count of URL bar selections of remote (synced device) tabs.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1305,6 +1320,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_searchengine_sum
   type: RECORD
+  description: Keyed count of URL bar selections that launched a search, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1315,6 +1331,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_searchsuggestion_sum
   type: RECORD
+  description: Keyed count of URL bar selections of search suggestions, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1325,6 +1342,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_switchtab_sum
   type: RECORD
+  description: Keyed count of URL bar selections that switched to an already-open tab.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1335,6 +1353,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_tabtosearch_sum
   type: RECORD
+  description: Keyed count of URL bar tab-to-search result selections, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1345,6 +1364,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_tip_sum
   type: RECORD
+  description: Keyed count of URL bar selections of tip results (redirect tips), keyed by tip type.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1355,6 +1375,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_topsite_sum
   type: RECORD
+  description: Keyed count of URL bar selections of Top Sites results.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1365,6 +1386,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_unknown_sum
   type: RECORD
+  description: Keyed count of URL bar result selections of unclassified types.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1375,6 +1397,7 @@
   mode: REPEATED
   name: scalar_parent_urlbar_picked_visiturl_sum
   type: RECORD
+  description: Keyed count of URL bar selections where the user navigated directly to a typed URL.
 - mode: NULLABLE
   name: default_private_search_engine
   type: STRING
@@ -1422,6 +1445,7 @@
   mode: REPEATED
   name: search_with_ads
   type: RECORD
+  description: Keyed count of search result page impressions containing ads, keyed by search engine and access point.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1432,6 +1456,7 @@
   mode: REPEATED
   name: ad_clicks
   type: RECORD
+  description: Keyed count of ad clicks on search result pages, keyed by search engine and access point.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1442,6 +1467,7 @@
   mode: REPEATED
   name: search_content_urlbar_sum
   type: RECORD
+  description: Keyed count of searches from the URL bar, keyed by search engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1452,6 +1478,7 @@
   mode: REPEATED
   name: search_content_urlbar_handoff_sum
   type: RECORD
+  description: Keyed count of searches via URL bar new-tab handoff, keyed by search engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1462,6 +1489,7 @@
   mode: REPEATED
   name: search_content_urlbar_persisted_sum
   type: RECORD
+  description: Keyed count of searches where the URL bar retained the term after submission, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1472,6 +1500,7 @@
   mode: REPEATED
   name: search_content_urlbar_searchmode_sum
   type: RECORD
+  description: Keyed count of URL bar search-mode searches, keyed by search engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1482,6 +1511,7 @@
   mode: REPEATED
   name: search_content_contextmenu_sum
   type: RECORD
+  description: Keyed count of context menu searches, keyed by search engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1492,6 +1522,7 @@
   mode: REPEATED
   name: search_content_about_home_sum
   type: RECORD
+  description: Keyed count of searches from the about:home page, keyed by search engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1502,6 +1533,7 @@
   mode: REPEATED
   name: search_content_about_newtab_sum
   type: RECORD
+  description: Keyed count of searches from the new tab page, keyed by search engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1512,6 +1544,7 @@
   mode: REPEATED
   name: search_content_searchbar_sum
   type: RECORD
+  description: Keyed count of searches from the dedicated search bar, keyed by search engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1522,6 +1555,7 @@
   mode: REPEATED
   name: search_content_system_sum
   type: RECORD
+  description: Keyed count of system-initiated searches, keyed by search engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1532,6 +1566,7 @@
   mode: REPEATED
   name: search_content_webextension_sum
   type: RECORD
+  description: Keyed count of extension-initiated searches, keyed by search engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1542,6 +1577,7 @@
   mode: REPEATED
   name: search_content_tabhistory_sum
   type: RECORD
+  description: Keyed count of searches from tab history navigation, keyed by search engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1552,6 +1588,7 @@
   mode: REPEATED
   name: search_content_reload_sum
   type: RECORD
+  description: Keyed count of searches triggered by page reload, keyed by search engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1562,6 +1599,7 @@
   mode: REPEATED
   name: search_content_unknown_sum
   type: RECORD
+  description: Keyed count of searches from unclassified entry points, keyed by search engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1572,6 +1610,7 @@
   mode: REPEATED
   name: search_withads_urlbar_sum
   type: RECORD
+  description: Keyed count of URL bar search result pages that contained ads, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1582,6 +1621,7 @@
   mode: REPEATED
   name: search_withads_urlbar_handoff_sum
   type: RECORD
+  description: Keyed count of new-tab handoff search result pages with ads, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1592,6 +1632,7 @@
   mode: REPEATED
   name: search_withads_urlbar_persisted_sum
   type: RECORD
+  description: Keyed count of persisted-URL-bar search result pages with ads, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1602,6 +1643,7 @@
   mode: REPEATED
   name: search_withads_urlbar_searchmode_sum
   type: RECORD
+  description: Keyed count of search-mode search result pages with ads, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1612,6 +1654,7 @@
   mode: REPEATED
   name: search_withads_contextmenu_sum
   type: RECORD
+  description: Keyed count of context menu search result pages with ads, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1622,6 +1665,7 @@
   mode: REPEATED
   name: search_withads_about_home_sum
   type: RECORD
+  description: Keyed count of about:home search result pages with ads, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1632,6 +1676,7 @@
   mode: REPEATED
   name: search_withads_about_newtab_sum
   type: RECORD
+  description: Keyed count of new tab page search result pages with ads, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1642,6 +1687,7 @@
   mode: REPEATED
   name: search_withads_searchbar_sum
   type: RECORD
+  description: Keyed count of search bar search result pages with ads, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1652,6 +1698,7 @@
   mode: REPEATED
   name: search_withads_system_sum
   type: RECORD
+  description: Keyed count of system-initiated search result pages with ads, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1662,6 +1709,7 @@
   mode: REPEATED
   name: search_withads_webextension_sum
   type: RECORD
+  description: Keyed count of extension-initiated search result pages with ads, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1672,6 +1720,7 @@
   mode: REPEATED
   name: search_withads_tabhistory_sum
   type: RECORD
+  description: Keyed count of tab history search result pages with ads, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1682,6 +1731,7 @@
   mode: REPEATED
   name: search_withads_reload_sum
   type: RECORD
+  description: Keyed count of reload-triggered search result pages with ads, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1692,6 +1742,7 @@
   mode: REPEATED
   name: search_withads_unknown_sum
   type: RECORD
+  description: Keyed count of unclassified-entry-point search result pages with ads, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1702,6 +1753,7 @@
   mode: REPEATED
   name: search_adclicks_urlbar_sum
   type: RECORD
+  description: Keyed count of ad clicks from URL bar searches, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1712,6 +1764,7 @@
   mode: REPEATED
   name: search_adclicks_urlbar_handoff_sum
   type: RECORD
+  description: Keyed count of ad clicks from new-tab handoff searches, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1722,6 +1775,7 @@
   mode: REPEATED
   name: search_adclicks_urlbar_persisted_sum
   type: RECORD
+  description: Keyed count of ad clicks from persisted-URL-bar searches, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1732,6 +1786,7 @@
   mode: REPEATED
   name: search_adclicks_urlbar_searchmode_sum
   type: RECORD
+  description: Keyed count of ad clicks from URL bar search-mode searches, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1742,6 +1797,7 @@
   mode: REPEATED
   name: search_adclicks_contextmenu_sum
   type: RECORD
+  description: Keyed count of ad clicks from context menu searches, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1752,6 +1808,7 @@
   mode: REPEATED
   name: search_adclicks_about_home_sum
   type: RECORD
+  description: Keyed count of ad clicks from about:home searches, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1762,6 +1819,7 @@
   mode: REPEATED
   name: search_adclicks_about_newtab_sum
   type: RECORD
+  description: Keyed count of ad clicks from new tab page searches, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1772,6 +1830,7 @@
   mode: REPEATED
   name: search_adclicks_searchbar_sum
   type: RECORD
+  description: Keyed count of ad clicks from search bar searches, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1782,6 +1841,7 @@
   mode: REPEATED
   name: search_adclicks_system_sum
   type: RECORD
+  description: Keyed count of ad clicks from system-initiated searches, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1792,6 +1852,7 @@
   mode: REPEATED
   name: search_adclicks_webextension_sum
   type: RECORD
+  description: Keyed count of ad clicks from extension-initiated searches, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1802,6 +1863,7 @@
   mode: REPEATED
   name: search_adclicks_tabhistory_sum
   type: RECORD
+  description: Keyed count of ad clicks from tab history navigation searches, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1812,6 +1874,7 @@
   mode: REPEATED
   name: search_adclicks_reload_sum
   type: RECORD
+  description: Keyed count of ad clicks from reload-triggered searches, keyed by engine.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1822,6 +1885,7 @@
   mode: REPEATED
   name: search_adclicks_unknown_sum
   type: RECORD
+  description: Keyed count of ad clicks from unclassified search entry points, keyed by engine.
 - mode: NULLABLE
   name: update_background
   type: BOOLEAN
@@ -1876,6 +1940,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_click_sum
   type: RECORD
+  description: Keyed count of Firefox Suggest result clicks, keyed by suggestion type.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1886,6 +1951,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_impression_sum
   type: RECORD
+  description: Keyed count of Firefox Suggest result impressions, keyed by suggestion type.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1896,6 +1962,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_help_sum
   type: RECORD
+  description: Keyed count of Firefox Suggest 'Learn More' help link clicks, keyed by suggestion type.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1906,6 +1973,7 @@
   mode: REPEATED
   name: contextual_services_topsites_click_sum
   type: RECORD
+  description: Keyed count of Top Sites tile clicks on the new tab page, keyed by tile position and source.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1916,6 +1984,7 @@
   mode: REPEATED
   name: contextual_services_topsites_impression_sum
   type: RECORD
+  description: Keyed count of Top Sites tile impressions on the new tab page, keyed by tile position and source.
 - mode: NULLABLE
   name: user_pref_browser_urlbar_suggest_quicksuggest_nonsponsored
   type: STRING
@@ -1942,6 +2011,7 @@
   mode: REPEATED
   name: a11y_theme
   type: RECORD
+  description: Keyed boolean indicators of Windows accessibility theme settings active for this client, keyed by theme attribute name.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1952,6 +2022,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_help_nonsponsored_bestmatch_sum
   type: RECORD
+  description: Keyed count of help link clicks on non-sponsored Best Match Firefox Suggest results.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1962,6 +2033,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_help_sponsored_bestmatch_sum
   type: RECORD
+  description: Keyed count of help link clicks on sponsored Best Match Firefox Suggest results.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1972,6 +2044,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_block_nonsponsored_sum
   type: RECORD
+  description: Keyed count of times a non-sponsored Firefox Suggest result was dismissed/blocked.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1982,6 +2055,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_block_sponsored_sum
   type: RECORD
+  description: Keyed count of times a sponsored Firefox Suggest result was dismissed/blocked.
 - fields:
   - mode: NULLABLE
     name: key
@@ -1992,6 +2066,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_block_sponsored_bestmatch_sum
   type: RECORD
+  description: Keyed count of times a sponsored Best Match Firefox Suggest result was blocked.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2002,6 +2077,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_block_nonsponsored_bestmatch_sum
   type: RECORD
+  description: Keyed count of times a non-sponsored Best Match Firefox Suggest result was blocked.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2012,6 +2088,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_click_sponsored_bestmatch_sum
   type: RECORD
+  description: Keyed count of clicks on sponsored Best Match Firefox Suggest results.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2022,6 +2099,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_click_nonsponsored_bestmatch_sum
   type: RECORD
+  description: Keyed count of clicks on non-sponsored Best Match Firefox Suggest results.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2032,6 +2110,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_impression_sponsored_bestmatch_sum
   type: RECORD
+  description: Keyed count of impressions of sponsored Best Match Firefox Suggest results.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2042,6 +2121,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_impression_nonsponsored_bestmatch_sum
   type: RECORD
+  description: Keyed count of impressions of non-sponsored Best Match Firefox Suggest results.
 - mode: NULLABLE
   name: user_pref_browser_urlbar_suggest_bestmatch
   type: STRING
@@ -2068,6 +2148,7 @@
   mode: REPEATED
   name: scalar_parent_browser_ui_interaction_content_context_sum
   type: RECORD
+  description: Keyed count of user interactions with the browser content area context menu, keyed by menu item action.
 - mode: NULLABLE
   name: text_recognition_api_performance_sum
   type: INTEGER
@@ -2178,6 +2259,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_block_dynamic_wikipedia_sum
   type: RECORD
+  description: Keyed count of times a dynamic Wikipedia Firefox Suggest result was blocked.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2188,6 +2270,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_block_weather_sum
   type: RECORD
+  description: Keyed count of times a weather Firefox Suggest result was blocked.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2198,6 +2281,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_click_dynamic_wikipedia_sum
   type: RECORD
+  description: Keyed count of clicks on dynamic Wikipedia Firefox Suggest results.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2208,6 +2292,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_click_nonsponsored_sum
   type: RECORD
+  description: Keyed count of clicks on non-sponsored Firefox Suggest results.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2218,6 +2303,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_click_sponsored_sum
   type: RECORD
+  description: Keyed count of clicks on sponsored Firefox Suggest results.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2228,6 +2314,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_click_weather_sum
   type: RECORD
+  description: Keyed count of clicks on weather Firefox Suggest results.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2238,6 +2325,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_help_dynamic_wikipedia_sum
   type: RECORD
+  description: Keyed count of help link clicks on dynamic Wikipedia Firefox Suggest results.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2248,6 +2336,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_help_nonsponsored_sum
   type: RECORD
+  description: Keyed count of help link clicks on non-sponsored Firefox Suggest results.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2258,6 +2347,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_help_sponsored_sum
   type: RECORD
+  description: Keyed count of help link clicks on sponsored Firefox Suggest results.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2268,6 +2358,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_help_weather_sum
   type: RECORD
+  description: Keyed count of help link clicks on weather Firefox Suggest results.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2278,6 +2369,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_impression_dynamic_wikipedia_sum
   type: RECORD
+  description: Keyed count of impressions of dynamic Wikipedia Firefox Suggest results.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2288,6 +2380,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_impression_nonsponsored_sum
   type: RECORD
+  description: Keyed count of impressions of non-sponsored Firefox Suggest results.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2298,6 +2391,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_impression_sponsored_sum
   type: RECORD
+  description: Keyed count of impressions of sponsored Firefox Suggest results.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2308,6 +2402,7 @@
   mode: REPEATED
   name: contextual_services_quicksuggest_impression_weather_sum
   type: RECORD
+  description: Keyed count of impressions of weather Firefox Suggest results.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2318,6 +2413,7 @@
   mode: REPEATED
   name: scalar_parent_sidebar_opened_sum
   type: RECORD
+  description: Keyed count of times Firefox Sidebar panels were opened, keyed by panel name.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2328,6 +2424,7 @@
   mode: REPEATED
   name: scalar_parent_sidebar_search_sum
   type: RECORD
+  description: Keyed count of searches within Firefox Sidebar panels, keyed by panel name.
 - fields:
   - mode: NULLABLE
     name: key
@@ -2338,6 +2435,7 @@
   mode: REPEATED
   name: scalar_parent_sidebar_link_sum
   type: RECORD
+  description: Keyed count of link activations within Firefox Sidebar panels, keyed by panel name.
 - name: places_previousday_visits_mean
   type: FLOAT
   mode: NULLABLE
@@ -2358,6 +2456,7 @@
   type: RECORD
   mode: REPEATED
   fields:
+  description: Keyed count of link activations within the Firefox Library panel, keyed by section.
   - name: key
     type: STRING
     mode: NULLABLE
@@ -2368,6 +2467,7 @@
   type: RECORD
   mode: REPEATED
   fields:
+  description: Keyed count of times the Firefox Library panel was opened, keyed by entry point.
   - name: key
     type: STRING
     mode: NULLABLE
@@ -2378,6 +2478,7 @@
   type: RECORD
   mode: REPEATED
   fields:
+  description: Keyed count of searches within the Firefox Library panel, keyed by section.
   - name: key
     type: STRING
     mode: NULLABLE
diff -bur --no-dereference --new-file /tmp/workspace/main-generated-sql/sql/moz-fx-data-shared-prod/telemetry_derived/clients_first_seen_v1/schema.yaml /tmp/workspace/generated-sql/sql/moz-fx-data-shared-prod/telemetry_derived/clients_first_seen_v1/schema.yaml
--- /tmp/workspace/main-generated-sql/sql/moz-fx-data-shared-prod/telemetry_derived/clients_first_seen_v1/schema.yaml	2026-06-08 14:05:29.657610516 +0000
+++ /tmp/workspace/generated-sql/sql/moz-fx-data-shared-prod/telemetry_derived/clients_first_seen_v1/schema.yaml	2026-06-08 14:05:24.822612439 +0000
@@ -6,6 +6,8 @@
 - mode: NULLABLE
   name: second_seen_date
   type: DATE
+  description: The date the server received the second ping from this client after
+    the first-seen date. Null if the client has not sent a second ping.
 - mode: NULLABLE
   name: client_id
   type: STRING

Link to full diff