Skip to content

Commit 1f2c51d

Browse files
authored
Update WinGet Source command (#6110)
* updating source command and image * Update WinGet source documentation
1 parent b0666bd commit 1f2c51d

5 files changed

Lines changed: 38 additions & 23 deletions

File tree

42.7 KB
Loading
149 KB
Loading
-33 KB
Binary file not shown.
39.7 KB
Loading

hub/package-manager/winget/source.md

Lines changed: 38 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,30 @@
11
---
2-
title: The winget source command
3-
description: Use the winget source command and subcommands to list and manage the repositories Windows Package Manager accesses.
2+
title: The WinGet source command
3+
description: Use the WinGet source command and subcommands to list and manage the sources WinGet accesses.
44
ms.date: 07/08/2025
55
ms.topic: reference
66
ms.custom: kr2b-contr-experiment
77
---
88

9-
# The winget source command
9+
# The WinGet source command
1010

11-
The [WinGet](index.md) **source** command allows you to manage sources for Windows Package Manager. With the **source** command, you can **add**, **list**, **update**, **remove**, **reset**, or **export** repositories.
11+
The [WinGet](index.md) **source** command allows you to manage sources. With the **source** command, you can **add**, **list**, **update**, **remove**, **reset**, or **export** WinGet sources.
1212

13-
A source repository provides the data for you to discover and install applications. Only use secure, trusted source locations.
13+
A WinGet source provides the data for you to discover and install applications. Only use secure, trusted sources.
1414

15-
Windows Package Manager specifies the following two default repositories, which you can list by using `winget source list`.
15+
WinGet specifies the following three default sources, which you can list by using `winget source list`.
1616

1717
- **msstore** - The Microsoft Store catalog.
18-
- **winget** - The Windows Package Manager app repository.
18+
- **winget** - The WinGet Community Repository for applications.
19+
- **winget-font** - The WinGet Community Repository for fonts.
1920

2021
## Usage
2122

2223
```cmd
2324
winget source <subcommand> <options>
2425
```
2526

26-
:::image type="content" source="./images/source.png" alt-text="Screenshot listing winget source command help options." lightbox="./images/source.png":::
27+
![winget source help](./images/source-help.png)
2728

2829
## Sub-Commands
2930

@@ -35,7 +36,7 @@ The following arguments are available.
3536
| **list** | Lists current sources. |
3637
| **update** | Updates current sources. |
3738
| **remove** | Removes current sources. |
38-
| **reset** | Resets default sources **winget** and **msstore**. |
39+
| **reset** | Resets default sources **msstore**, **winget**, and **winget-font**. |
3940
| **export** | Exports current sources. |
4041

4142
## Options
@@ -107,12 +108,17 @@ The **add** subcommand supports the optional **type** parameter, which tells the
107108

108109
The **list** subcommand enumerates the currently enabled sources, or provides details on a specific source.
109110

111+
> [!NOTE]
112+
> When a source is set to be explicit, it must be specifically targeted. The **winget-font** source is set to explicit by default. This means any other WinGet commands must directly reference the source using either "--source winget-font" or "-s winget-font" to be included.
113+
110114
Usage:
111115

112116
```cmd
113117
winget source list [[-n] <name>] [<options>]
114118
```
115119

120+
![winget source list](./images/source-list.png)
121+
116122
#### Aliases
117123

118124
The following aliases are available for this subcommand:
@@ -144,34 +150,41 @@ The following options are available.
144150

145151
#### list all
146152

147-
The **list** subcommand by itself, `winget source list`, provides the complete list of supported sources:
153+
The **list** subcommand by itself, `winget source list`, provides the complete list of configured sources:
148154

149155
```output
150-
Name Arg
151-
-----------------------------------------
152-
winget https://winget.azureedge.net/cache
156+
Name Argument Explicit
157+
------------------------------------------------------------------
158+
msstore https://storeedgefd.dsx.mp.microsoft.com/v9.0 false
159+
winget https://cdn.winget.microsoft.com/cache false
160+
winget-font https://cdn.winget.microsoft.com/fonts true
153161
```
154162

155163
#### list source details
156164

157165
To get complete details about a source, pass in the name of the source. For example:
158166

159167
```cmd
160-
winget source list --name Contoso
168+
winget source list --name winget
161169
```
162170

163171
Returns the following output:
164172

165173
```output
166-
Name : Contoso
167-
Type : Microsoft.PreIndexed.Package
168-
Arg : https://pkgmgr-int.azureedge.net/cache
169-
Data : AppInstallerSQLiteIndex-int_g4ype1skzj3jy
170-
Updated: 2020-4-14 17:45:32.000
174+
Field Value
175+
--------------------------------------------------
176+
Name winget
177+
Type Microsoft.PreIndexed.Package
178+
Argument https://cdn.winget.microsoft.com/cache
179+
Data Microsoft.Winget.Source_8wekyb3d8bbwe
180+
Identifier Microsoft.Winget.Source_8wekyb3d8bbwe
181+
Trust Level Trusted|StoreOrigin
182+
Explicit false
183+
Updated 2025-12-11 08:30:25.000
171184
```
172185

173186
- `Name` is the name of the source.
174-
- `Type` is the type of repo.
187+
- `Type` is the type of source.
175188
- `Arg` is the URL or path the source uses.
176189
- `Data` is the optional package name, if appropriate.
177190
- `Updated` is the last date and time the source was updated.
@@ -353,11 +366,13 @@ Returns the following output:
353366

354367
## Source agreement
355368

356-
An individual **source** might request that the user agree to the terms presented before adding or using the repository. If a user doesn't accept or acknowledge the agreement, they won't be able to access the source.
369+
An individual **source** may request that the user agree to agreements presented before adding or using the source. If a user does not accept the agreements, WinGet will not be able to access the source.
370+
371+
You can use the **--accept-source-agreements** option to accept the source agreements and avoid the prompt.
357372

358-
You can use the **--accept-source-agreements** option to accept the source license agreement and avoid the prompt.
373+
Many WinGet commands evaluate all configured sources. If any configured source requires agreements, WinGet will prompt before using those sources. Source agreements are required to be accepted before use. If a source updates agreement terms, or if a source is removed and readded (as in the case of `winget source reset --force`) agreements will be presented again.
359374

360-
:::image type="content" source="./images/source-license.png" alt-text="Screenshot showing the winget source command with flag to accept agreements." lightbox="./images/source-license.png":::
375+
![winget source agreement](./images/source-agreement.png)
361376

362377
## Related topics
363378

0 commit comments

Comments
 (0)