Open Settings from the sidebar footer. It is organized into three side-tabs.
General tab #
Default package values #
| Field | Description |
|---|---|
| Default App Script Author | Pre-fills the AppScriptAuthor field in every new package. Leave empty to preserve the toolkit’s own default. |
| Default Require Admin | Tri-state (Not Defined / True / False). “Not Defined” preserves the toolkit value; True/False overrides it for new packages. |
| Default Output Folder | Where exported .zip packages are saved in desktop mode. In the desktop app a Browse button opens a native folder picker. |
Documentation options — locked in free edition #
| Field | Description |
|---|---|
| Include README.md in exported packages | When enabled, adds a generated README.md with package metadata, parameters, and deployment phases into every exported zip. Locked in free edition. |
Package storage — locked in free edition #
| Field | Description |
|---|---|
| Package Storage Path | Sets a central / shared storage location so multiple users can collaborate on the same package workspace. Default: %AppData%\XOAP\PackageWizard. Locked in free edition — the text input and Browse button are displayed but disabled. |
The Save Settings button at the top of the page saves General tab values and any pending Package Configuration edits in one action.
PSADT toolkit tab #
Active toolkit for export #
Shows which toolkit will be used for script generation and export:
- Source label —
Custom,Bundled, orNo Toolkit Available - Module Version — detected from
PSAppDeployToolkit/PSAppDeployToolkit.psd1 - Custom Extensions included — badge shown if
PSAppDeployToolkit.Extensionsis present - Refresh — re-queries the server
Below the status card:
- Auto-check for toolkit updates on startup — toggles GitHub version check at startup
Resolution order (top wins):
- Custom toolkit path (if set and valid) — paid feature (see below)
- Downloaded toolkit in
%AppData%\XOAP\PackageWizard\Toolkit\{tag}\ - Bundled template shipped with the installer
Download latest from GitHub #
- Large Download Latest PSADT button — fetches the latest release from
github.com/PSAppDeployToolkit/PSAppDeployToolkit, extracts it (zip-slip protected), and sets it as the active toolkit - Displays the latest release tag and an “Update available” badge when applicable
Use custom toolkit — locked in free edition #
| Field | Description |
|---|---|
| Custom path | A folder you control that contains PSAppDeployToolkit/PSAppDeployToolkit.psd1. Useful for custom branding, extensions, and forks. |
| Set Path | Validates and activates the custom path |
Locked in free edition. Both the text input and the button are displayed but disabled.
Package configuration tab #
Reads Config/config.psd1 from the active toolkit and renders each section as a card.
| Section | Contents | Editable? |
|---|---|---|
| Assets | Icon paths, banner images, company logo | Free: read-only (locked badge) — Paid: editable |
| MSI | MutexWaitTime, MSI logging verbosity, InstallParamsSilent, LoggingOptions, LogPath, etc. | Free & Paid: editable |
| Toolkit | Toolkit file name, naming conventions, compression level | Free: read-only (locked badge) — Paid: editable |
| UI | Dialog defer times, default language, banner height | Free: read-only (locked badge) — Paid: editable |
For each field the UI shows:
- The field key (e.g.
MSI_LogPath) - Any comment/description parsed out of the
.psd1 - A form control appropriate for the type (text input, number input, or True/False toggle)
Editing a field and clicking Save Settings (top of page) writes the changes back to config.psd1 (with zipslip / path-traversal protection). The signature block, if present, is stripped on save.