diff --git a/doc/windows/package-manager/package/manifest.md b/doc/windows/package-manager/package/manifest.md
index f7dec8f40a..e479de13e0 100644
--- a/doc/windows/package-manager/package/manifest.md
+++ b/doc/windows/package-manager/package/manifest.md
@@ -58,6 +58,7 @@ a single installer and a single locale. If more than one installer or locale is
 
 The partitioning scheme was added to help with GitHub's UX. Folders with thousands of children do not render well in the browser.
 
+Locale fields use BCP 47 language tags. Both regional tags such as `en-US` and language-only tags such as `en` are supported; a language-only tag can match an available regional locale for the user's language.
 
 ```YAML
 PackageIdentifier:  # Publisher.package format.
diff --git a/doc/windows/package-manager/winget/index.md b/doc/windows/package-manager/winget/index.md
index 888d904736..78a046952e 100644
--- a/doc/windows/package-manager/winget/index.md
+++ b/doc/windows/package-manager/winget/index.md
@@ -77,7 +77,7 @@ The current version of the **winget** tool supports the following options.
 | **--logs,--open-logs** | Open the default logs location |
 | **--verbose,--verbose-logs** | Enables verbose logging for winget |
 | **--disable-interactivity** | Disable interactive prompts |
-| **--output-locale** | Language to use for the output of this command (BCP47 format). Overrides the `output.locale` setting and does not affect `--locale`. |
+| **--output-locale** | Language to use for the output of this command (BCP 47 format). Overrides the `output.locale` setting and does not affect `--locale`. |
 
 ## Supported installer formats
 
diff --git a/doc/windows/package-manager/winget/install.md b/doc/windows/package-manager/winget/install.md
index 9d8a620544..d2866482f2 100644
--- a/doc/windows/package-manager/winget/install.md
+++ b/doc/windows/package-manager/winget/install.md
@@ -51,7 +51,7 @@ The options allow you to customize the install experience to meet your needs.
 | **--force** | Override the installer hash check. |
 | **-a, --architecture** | Select the architecture |
 | **--installer-type** | Select the installer type |
-| **--locale** | Locale to use (BCP47 format) |
+| **--locale** | Locale to use (BCP 47 format, such as `en-US` or the language-only tag `en`) |
 | **--custom** | Arguments to be passed on to the installer in addition to the defaults |
 | **--ignore-security-hash** | Ignore the installer hash check failure |
 | **--skip-dependencies** | Skip processing package dependencies and Windows features |
diff --git a/doc/windows/package-manager/winget/settings.md b/doc/windows/package-manager/winget/settings.md
index 995a6fd0eb..335c3ca184 100644
--- a/doc/windows/package-manager/winget/settings.md
+++ b/doc/windows/package-manager/winget/settings.md
@@ -88,7 +88,7 @@ The `scope` behavior affects the choice between installing a package for the cur
 
 #### Locale
 
-The `locale` behavior affects the choice of installer based on installer locale. The matching parameter is `--locale`, and uses bcp47 language tag.
+The `locale` behavior affects the choice of installer based on installer locale. The matching parameter is `--locale`, and uses a BCP 47 language tag. Both regional tags such as `en-US` and language-only tags such as `en` are supported. A language-only preference can match an available regional installer locale for the user's language.
 
 ```json
     "installBehavior": {
diff --git a/doc/windows/package-manager/winget/show.md b/doc/windows/package-manager/winget/show.md
index acb24bd5e9..fd277f6a09 100644
--- a/doc/windows/package-manager/winget/show.md
+++ b/doc/windows/package-manager/winget/show.md
@@ -46,7 +46,7 @@ The following options are available.
 | **--scope** | Select install scope (user or machine). |
 | **-a, --architecture** | Select the architecture. |
 | **--installer-type** | Select the installer type. |
-| **--locale** | Locale to use (BCP47 format). |
+| **--locale** | Locale to use (BCP 47 format, such as `en-US` or the language-only tag `en`). |
 | **--header** | Optional Windows-Package-Manager REST source HTTP header. |
 | **--accept-source-agreements** | Accept all source agreements during source operations. |
 | **-?, --help** | Gets additional help on this command. |
diff --git a/doc/windows/package-manager/winget/upgrade.md b/doc/windows/package-manager/winget/upgrade.md
index 8da795446b..27c6894140 100644
--- a/doc/windows/package-manager/winget/upgrade.md
+++ b/doc/windows/package-manager/winget/upgrade.md
@@ -46,7 +46,7 @@ The options allow you to customize the upgrade experience to meet your needs.
 | **--custom**                      | Arguments to be passed on to the installer in addition to the defaults.                                                     |
 | **--scope**                       | Select installed package scope filter (user or machine).                                                                    |
 | **-a, --architecture**            | Select the architecture to install.                                                                                         |
-| **--locale**                      | Locale to use (BCP47 format).                                                                                               |
+| **--locale**                      | Locale to use (BCP 47 format, such as `en-US` or the language-only tag `en`).                                             |
 | **--ignore-security-hash**        | Ignore the installer hash check failure.                                                                                    |
 | **--ignore-local-archive-malware-scan** | Ignore the malware scan performed as part of installing an archive-type package from a local manifest.                  |
 | **--accept-package-agreements**   | Accept all license agreements for packages.                                                                                 |