Full schema reference

The complete property-by-property reference for mpdev-schema.json (Master Packager Dev 2.2.0).

Source of truth: C:\Program Files\Master Packager Ltd\Master Packager Dev\mpdev-schema.json or MPDEV schema URL.

Each type's section includes the description, the full property table, required-set, and any cross-property validators.

Conventions:

• Required column – yes means the property is required by the type itself. package required means it can be defined in the common section OR in BOTH per-output sections (see JSON Project Structure).
• Validators column – names of every validator that runs against the property. See Validation for definitions.

Index of types

#	Type	Used in
1	Package	Root
2	MsiPackage	$.msi
3	MsixPackage	$.msix
4	FileSystemEntry	fileSystemEntries[]
5	Registry	registries[]
6	Shortcut	shortcuts[]
7	UrlShortcut	urlShortcuts[]
8	EnvVar	environmentVariables[]
9	MsiEnvVarConfig	environmentVariables[].msi
10	FileAssociation	fileAssociations[]
11	Verb	fileAssociations[].verbs[]
12	ContextMenu	contextMenu[]
13	Service	services[]
14	MsiServiceConfig	services[].msi
15	Startup	startup[]
16	FirewallException	firewallExceptions[]
17	AzureTrustedSigningSignature	digitalSignature
18	ThumbprintSignature	digitalSignature
19	TestCertificateSignature	digitalSignature
20	SecondaryUpgradeCode	msi.secondaryUpgradeCodes[]
21	MsiProperty	msi.properties[]
22	MsiIniFile	msi.iniFiles[]
23	MsiIniFileSection	msi.iniFiles[].sections[]
24	MsiIniFileValue	msi.iniFiles[].sections[].values[]
25	MsiCustomAction	msi.customActions
26	MsiCustomActionExe	msi.customActions.exe[]
27	MsiCustomActionDll	msi.customActions.dll[]
28	MsiCustomActionRegisterDll	msi.customActions.registerDll[]
29	MsiCustomActionPowershell	msi.customActions.powershell[]
30	MsiCustomActionInstallDriver	msi.customActions.installDriver[]
31	MsiCustomActionSetProperty	msi.customActions.setProperty[] ★ NEW 2.2.0
32	MsiInstallDialog	msi.installDialog
33	MsiPromptAppsAfterInstall	msi.installDialog.promptAppsAfterInstall[]
34	MsiPackageDependency	msi.packageDependencies[]
35	MsiPackageDependencyInstall	msi.packageDependencies[].install
36	MsiPackageDependencyInstallWinGet	msi.packageDependencies[].install.winGet
37	MsiUpdater	msi.updater
38	MsiUpdaterLatestVersionDescriptor	msi.updater.latestVersionDescriptor
39	MsiUpdaterScheduling	msi.updater.scheduling
40	MsiUpdaterNotifications	msi.updater.notifications
41	MsiUpdaterLogging	msi.updater.logging
42	MsixDeviceCapability	msix.deviceCapabilities[]
43	MsixDevice	msix.deviceCapabilities[].devices[]
44	MsixDeviceFunction	msix.deviceCapabilities[].devices[].functions[]
45	MsixPackageDependency	msix.packageDependencies[] ★ NEW 2.2.0
46	Psf	msix.psf
47	MsixInstallDialog	msix.installDialog

---

Package

Common package-level details. Properties in this section are automatically inherited by both MSI and MSIX builds.

Required: outputTypes. Most other properties are package required – they must be set either at the common level OR inside both msi and msix sections.

Property	Type	Required	Default	Validators	Description
outputTypes	string[] enum: msi, msix	yes	–	required, valid value, min length 1	Which package formats to build.
msi	object (MsiPackage)	no	–	–	MSI-specific section (overrides + MSI-only).
msix	object (MsixPackage)	no	–	–	MSIX-specific section (overrides + MSIX-only).
outputDirectory	string	package required	–	required, min, valid path	Directory where built files go. Cleaned at start of build.
outputFileName	string	no	$.packageName $.version.$.outputType	–	File name without extension.
packageName	string	package required	–	required, min	Product name.
publisher	string	package required	–	required, min, valid publisher	Publisher. Distinguished Name if MSIX is built without a real signature.
version	string	package required	–	required, min, valid version	Package version (Major.Minor.Build[.Revision], Major > 0).
platform	string enum: x86, x64, Arm, Arm64, Neutral	package required	–	required, valid value	Target platform.
installDir	string	package required	–	required, min, valid absolute path	Absolute install directory.
icon	string	package required	–	required, valid icon source	.ico/.png/.exe/.dll. Append ,index for exe/dll.
compressionLevel	string enum: None, Normal, Min, Max	no	Normal	valid value	Package compression.
fileSystemEntries	array of FileSystemEntry	no	–	–	Files and directories to ship.
registries	array of Registry	no	–	duplicate registry check	Registry writes.
shortcuts	array of Shortcut	no	–	at least one msix shortcut required (when MSIX)	Application shortcuts (Start menu / app entry).
urlShortcuts	array of UrlShortcut	no	–	–	Web URL shortcuts.
environmentVariables	array of EnvVar	no	–	–	Environment variables.
fileAssociations	array of FileAssociation	no	–	–	File type associations.
contextMenu	array of ContextMenu	no	–	digital signature required - context menu (MSI)	Right-click integration.
services	array of Service	no	–	–	Windows services.
startup	array of Startup	no	–	–	Logon / after-install launches.
firewallExceptions	array of FirewallException	no	–	–	Firewall rules.
digitalSignature	object (Azure… / Thumbprint… / Test…)	no	–	valid-azure-trusted-signing	Digital signature for both outputs. oneOf the three types.

---

MsiPackage

MSI-specific section. Defines MSI-only properties and can override any property from the common section.

All properties from Package (except outputTypes, msi, msix) are also valid here as overrides. The MSI-only properties are:

Property	Type	Required	Default	Validators	Description
cabName	string	no	#Disk.cab	–	CAB file name. # prefix = embedded, no prefix = external, empty = noncompressed.
cabSizeInBytes	integer	no	314572800 (300 MiB)	–	Max CAB size. Ignored for noncompressed builds.
baseMsi	string	no	Default.msi shipped with MPDEV	valid path on disk	Path to a custom MSI template.
upgradeCode	string (GUID)	no	–	valid upgrade code	Product upgrade code (same across versions of the same product).
secondaryUpgradeCodes	array of SecondaryUpgradeCode	no	–	–	Upgrade codes from previous product versions.
properties	array of MsiProperty	no	–	–	Custom MSI properties.
iniFiles	array of MsiIniFile	no	–	–	INI files to create or modify.
customActions	object (MsiCustomAction)	no	–	unique custom action name	Custom actions container.
installDialog	object (MsiInstallDialog)	no	native MSI UI	–	Branded install dialog.
detectRunningProcesses	string[] (regex)	no	–	–	Extra processes to detect / prompt to close before install.
packageDependencies	array of MsiPackageDependency	no	–	–	Pre-install dependency checks.
updater	object (MsiUpdater)	no	–	digital signature required - updater, valid install dir - updater	Background auto-updater service.

---

MsixPackage

MSIX-specific section. Defines MSIX-only properties and can override any property from the common section.

All properties from Package (except outputTypes, msi, msix) are also valid here as overrides. The MSIX-only properties are:

Property	Type	Required	Default	Validators	Description
packageDisplayName	string	no	$.packageName	–	Friendly app name.
publisherDisplayName	string	no	$.publisher	–	Friendly publisher name.
packageDescription	string	no	–	–	Long description in manifest.
minVersion	string	no	10.0.16299.0	valid version	Minimum Windows build supported.
maxVersionTested	string	no	10.0.26100.0	valid version	Highest Windows build validated against.
capabilities	string[] enum (see below)	no	–	valid value	Restricted/general capabilities.
deviceCapabilities	array of MsixDeviceCapability	no	–	–	Hardware/device capabilities.
packageDependencies ★	array of MsixPackageDependency	no	–	unique name	NEW 2.2.0. Framework MSIX dependencies.
manifest	string	no	–	–	Path to a fully custom AppxManifest.xml.
allowExternalContent	boolean	no	false	–	Build a sparse MSIX.
psf	object (Psf)	no	–	–	Package Support Framework.
installDialog	object (MsixInstallDialog)	no	–	–	MSIX install UI.

capabilities enum values: accessoryManager, allJoyn, allowElevation, appointments, backgroundMediaPlayback, blockedChatMessages, chat, codeGeneration, contacts, customInstallActions, documentsLibrary, enterpriseAuthentication, gazeInput, globalMediaControl, graphicsCapture, graphicsCaptureProgrammatic, graphicsCaptureWithoutBorder, internetClient, internetClientServer, lowLevelDevices, musicLibrary, objects3D, offlineMapsManagement, phoneCall, phoneCallHistoryPublic, picturesLibrary, privateNetworkClientServer, recordedCallsFolder, remoteSystem, removableStorage, runFullTrust, sharedUserCertificates, spatialPerception, systemManagement, uiAccess, unvirtualizedResources, userAccountInformation, userDataTasks, userNotificationListener, videosLibrary, voipCall.

---

FileSystemEntry

A file or directory included in the package. See Files and Folders for behaviour rules.

Property	Type	Required	Default	Validators	Description
sourcePath	string	yes	–	required, min, valid path on disk	Path to a file/dir on your disk.
targetPath	string	yes	–	required, min, valid absolute path	Absolute path inside the installed package.

---

Registry

A Windows registry key/value to write at install. See Registry.

Property	Type	Required	Default	Validators	Description
key	string	yes	–	required, min, valid registry key	Full registry key. Must start with one of the five hives.
name	string	no	–	–	Value name. null/empty = the key's default value.
type	enum: String, ExpandString, Binary, DWord, MultiString, QWord	no	String	valid value	Value type.
value	string	no	–	–	Value (format per type, see Registry).

Cross-property: duplicate registry check – (key, name) pairs must be unique across the array.

---

Shortcut

Application shortcut. For MSIX, also functions as the app entry. See Shortcuts.

Property	Type	Required	Default	Validators	Description
target	string	yes	–	required, min, valid path	What the shortcut launches.
name	string	no	filename of target minus extension	–	Display name.
location	string	no	Start Menu\Programs[\<packageName>]	–	Folder to create the shortcut in.
arguments	string	no	–	–	Command-line arguments.
workingDirectory	string	no	–	–	Working directory.
description	string	no	–	–	Tooltip text.
icon	string	no	icon extracted from target	valid icon source	.ico/.png/.exe/.dll.

---

UrlShortcut

A .url web shortcut.

Property	Type	Required	Default	Validators	Description
name	string	yes	–	required, min, unique url shortcut name	Shortcut file name (without .url).
url	string	yes	–	required, min, valid http url	HTTP/HTTPS target URL.
location	string	no	same logic as Shortcut.location	–	Folder to create the file in.

---

EnvVar

An environment variable. See Environment Variables.

Property	Type	Required	Default	Validators	Description
name	string	yes	–	required, min	Variable name.
value	string	yes	–	required, min	Variable value.
msi	object (MsiEnvVarConfig)	no	see defaults below	–	MSI-specific configuration.

Default msi: { "type": "System", "onInstall": "CreateOrUpdate", "onUninstall": "Remove", "valueAction": "AppendEnd" }.

---

MsiEnvVarConfig

MSI-specific configuration for an environment variable.

Property	Type	Required	Default	Validators	Description
type	enum: System, User	no	System	valid value	Variable scope.
onInstall	enum: Create, CreateOrUpdate, Remove	no	CreateOrUpdate	valid value	Action on install.
onUninstall	enum: Remove, Keep	no	Remove	valid value	Action on uninstall.
valueAction	enum: Replace, AppendStart, AppendEnd	no	AppendEnd	valid value	How value interacts with an existing value.

---

FileAssociation

A file extension → executable association. See File Associations and Context Menu.

Property	Type	Required	Default	Validators	Description
fileType	string	yes	–	required, min	Extension without ., e.g., My Company.
executable	string	yes	–	required, min	Executable to launch.
icon	string	no	–	valid icon source	Document icon source.
progId	string	no	<fileType>_auto_file	–	Programmatic ID.
verbs	array of Verb	no	[ { "name": "Open", "arguments": "\"%1\"" } ]	–	Verbs (Open, Edit, …).

---

Verb

A verb on a file association.

Property	Type	Required	Default	Validators	Description
name	string	yes	–	required, min	Verb name (Open, Edit, Print, …).
arguments	string	no	–	–	Arguments. %1 is the selected file.

---

ContextMenu

Right-click context-menu integration. See Context Menu.

Property	Type	Required	Default	Validators	Description
fileType	enum: *, Directory, Directory\\Background	yes	–	required, valid value	What is right-clicked. Enum tightened in 2.2.0.
executable	string	yes	–	required, min, valid path	Executable to invoke.
name	string	yes	–	required, min	Display name in menu.
icon	string	no	–	valid path	Existing path on the target system.
arguments	string	no	"%1"	–	Arguments.
condition	string (regex)	no	–	–	Visibility regex against the selected path.

Cross-property: digital signature required - context menu – when used in MSI, requires digitalSignature.

---

Service

Windows service installed by the package. See Services.

Property	Type	Required	Default	Validators	Description
name	string (max 256)	yes	–	required, min, max, illegal characters (no / or \)	Service name.
displayName	string (max 256)	no	–	max	UI display name.
executable	string	yes	–	required, min, valid path in package	Path inside the package.
arguments	string	no	–	–	Command-line args.
startAccount	enum: LocalSystem, LocalService, NetworkService (MSI also accepts custom values)	no	LocalSystem	valid service start account	Account the service runs as.
startupType	enum: Auto, Manual, Disabled	no	Auto	valid value	When to start.
description	string	no	–	–	Description.
dependencies	string[]	no	–	–	Other services / load groups that must start first.
msi	object (MsiServiceConfig)	no	see below	–	MSI-only config.

Default msi: { "loadOrderGroup": null, "errorControl": "Normal", "serviceType": "OwnProcess", "interactive": false, "description": null }.

---

MsiServiceConfig

Property	Type	Required	Default	Validators	Description
loadOrderGroup	string	no	–	–	Load-order group name.
errorControl	enum: Ignore, Normal, Critical	no	Normal	valid value	Action if the service fails to start.
serviceType	enum: OwnProcess, ShareProcess	no	OwnProcess	valid value	Process model.
interactive	boolean	no	false	–	Service can interact with desktop. Requires LocalSystem.
startAccountPassword	string	no	–	valid start account password	Password for a custom startAccount. Forbidden for built-in accounts.

---

Startup

Run an executable at user logon or right after install.

Property	Type	Required	Default	Validators	Description
type	enum: OnLogin, AfterInstall	yes	–	required, valid value	When to run.
executable	string	yes	–	required, min, valid path in package	Path inside the package.
arguments	string	no	–	–	Command-line args.
workingDirectory	string	no	–	–	Working directory.

---

FirewallException

Windows Firewall rule.

Property	Type	Required	Default	Validators	Description
name	string	yes	–	required, min	Rule display name.
path	string	yes	–	required, min, valid path	Path to the file (inside or outside the package).
bound	string[] enum: in, out	yes	–	required, valid value	Direction(s).
profile	string[] enum: private, public, domain, any	yes	–	required, valid value	Network profile(s).
protocol	string enum: tcp, udp, any	yes	–	required, valid value	Protocol (single string, not array).

---

AzureTrustedSigningSignature

Sign with Microsoft's Trusted Signing service. See Digital Signature.

Property	Type	Required	Default	Validators	Description
signWith	const "AzureTrustedSigning"	yes	–	required, valid value	Signing method.
endpoint	URL	yes	–	required, min, valid http url	Regional endpoint.
codeSigningAccountName	string	yes	–	required, min	Account name.
certificateProfileName	string	yes	–	required, min	Cert profile name.
correlationId	string	no	–	–	Optional correlation ID for build logs.
credentials	string[] enum (see below)	no	["EnvironmentCredential"]	valid value	Auth methods, tried in order.
timestampServer	URL	yes	–	required, min, valid http url, valid timestamp server	RFC 3161 server. Mandatory.
exclusions	string[] (regex)	no	–	valid regex	Files to skip during file signing.

credentials enum values: EnvironmentCredential, ManagedIdentityCredential, WorkloadIdentityCredential, SharedTokenCacheCredential, VisualStudioCredential, AzureCliCredential, AzurePowerShellCredential, AzureDeveloperCliCredential, InteractiveBrowserCredential. (VisualStudioCodeCredential was removed in 2.2.0.)

Cross-property: valid-azure-trusted-signing – verifies a successful connection to the Trusted Signing endpoint.

---

ThumbprintSignature

Sign with a local certificate identified by its thumbprint.

Property	Type	Required	Default	Validators	Description
signWith	const "Thumbprint"	yes	–	required, valid value	Signing method.
thumbprint	string	yes	–	required, min, valid thumbprint	40-char hex thumbprint.
timestampServer	URL	yes	–	required, min, valid http url, valid timestamp server	RFC 3161 server.
exclusions	string[] (regex)	no	–	valid regex	Files to skip.

---

TestCertificateSignature

Generate a fresh self-signed certificate per build.

Property	Type	Required	Default	Validators	Description
signWith	const "GenerateTestCertificate"	yes	–	required, valid value	Signing method.
timestampServer	URL	yes	–	required, min, valid http url, valid timestamp server	RFC 3161 server.
exclusions	string[] (regex)	no	–	valid regex	Files to skip.

---

SecondaryUpgradeCode

Upgrade code from a previous version of the same product.

Property	Type	Required	Default	Validators	Description
upgradeCode	string (GUID)	no	–	valid upgrade code, unique upgrade code	Old upgrade code.
version	string	no	$.version	valid upgrade version	Highest legacy version (Major.Minor.Build).

---

MsiProperty

Custom MSI property.

Property	Type	Required	Default	Validators	Description
name	string	yes	–	required, min	Property name.
value	string	conditional	–	property value conditionally required, min	Required unless saveOnRepair: true.
saveOnRepair	boolean	no	false	–	Persist runtime value across repair operations.

---

MsiIniFile

INI file managed by MSI at install.

Property	Type	Required	Default	Validators	Description
targetPath	string	yes	–	required, min, valid path	Absolute path to INI on the install machine.
sections	array of MsiIniFileSection	yes	–	required, min items 1	INI sections to manage.

---

MsiIniFileSection

Property	Type	Required	Default	Validators	Description
section	string	yes	–	required, min	INI [Section] name.
values	array of MsiIniFileValue	yes	–	required, min items 1	Key-value pairs in the section.

---

MsiIniFileValue

Property	Type	Required	Default	Validators	Description
key	string	yes	–	required, min	INI key.
value	string	yes	–	required, min	INI value. Supports [Property] substitution.
action	enum: CreateOrUpdate, Create, CreateOrAppend	yes	CreateOrUpdate	required, valid value	What to do at install.

---

MsiCustomAction

Container for the six kinds of custom actions.

Property	Type	Required	Default	Validators	Description
exe	array of MsiCustomActionExe	no	–	–	EXE custom actions.
dll	array of MsiCustomActionDll	no	–	–	DLL function custom actions.
registerDll	array of MsiCustomActionRegisterDll	no	–	–	regsvr32 custom actions.
powershell	array of MsiCustomActionPowershell	no	–	–	PowerShell script custom actions.
installDriver	array of MsiCustomActionInstallDriver	no	–	–	Driver .inf install custom actions.
setProperty ★	array of MsiCustomActionSetProperty	no	–	–	NEW 2.2.0. Conditional property setter.

Cross-property: unique custom action name – every name across types must be unique.

---

MsiCustomActionExe

Property	Type	Required	Default	Validators	Description
name	string	yes	–	required, min	Action name.
filePath	string	yes	–	required, min, valid path, valid file type	Executable path.
arguments	string	no	–	–	Args.
condition	string	no	–	–	MSI condition.
sequence	string (StartOfExecution, EndOfExecution, or short integer)	no	EndOfExecution	valid custom action sequence	When to run.
continueOnError	boolean	no	false	–	Don't fail install on action error.

---

MsiCustomActionDll

Property	Type	Required	Default	Validators	Description
name	string	yes	–	required, min	Action name.
filePath	string	yes	–	required, min, valid path on disk, valid file type	DLL path on disk (embedded into MSI).
entryPoint	string	no	–	–	Exported function name.
arguments	string	no	–	–	Args.
condition	string	no	–	–	MSI condition.
sequence	string	no	EndOfExecution	valid custom action sequence	When to run.
continueOnError	boolean	no	false	–	–

---

MsiCustomActionRegisterDll

Property	Type	Required	Default	Validators	Description
filePath	string	–	–	valid path in package, valid file type	DLL inside the package.
unregisterOnUninstall	boolean	no	true	–	regsvr32 /u on uninstall.

---

MsiCustomActionPowershell

Property	Type	Required	Default	Validators	Description
filePath	string	yes	–	required, min, valid path on disk, valid file type	.ps1 path on disk (content embedded into MSI).
condition	string	no	–	–	MSI condition.
sequence	string	no	EndOfExecution	valid custom action sequence	When to run.
continueOnError	boolean	no	false	–	–

---

MsiCustomActionInstallDriver

Property	Type	Required	Default	Validators	Description
filePath	string	–	–	valid path in package, valid file type	.inf inside the package.
importCertificate	boolean	no	false	–	Import driver cert to TrustedPublishers before install.
removeOnUninstall	boolean	no	true	–	Remove driver on uninstall.

---

MsiCustomActionSetProperty

★ NEW in 2.2.0. Sets an MSI property at runtime, optionally gated by a condition. Useful for computed property values.

Property	Type	Required	Default	Validators	Description
propertyName	string	yes	–	required, min	Property name to set.
propertyValue	string	yes	–	required, min	Value (supports [Property] substitution).
condition	string	no	–	–	MSI condition.
sequence	string	no	StartOfExecution	valid custom action sequence	When to run. Default differs from other actions.

---

MsiInstallDialog

Branded MSI install dialog. Omitting this section uses the native MSI UI.

Property	Type	Required	Default	Validators	Description
packageDescription	string	no	–	–	Description on the main page.
publisherUrl	string	no	–	–	Publisher website link.
releaseNotesUrl	string	no	–	–	Release notes link.
eulaUrl	string	no	–	–	EULA link.
primaryAccent	string (hex RGB)	no	–	–	Accent color, e.g. #01787B.
promptAppsAfterInstall	array of MsiPromptAppsAfterInstall	no	–	–	Apps offered for launch after install.

---

MsiPromptAppsAfterInstall

Property	Type	Required	Default	Validators	Description
displayName	string	yes	–	required, min	Label shown next to the launch checkbox.
file	string	yes	–	required, min, valid path in package	Executable inside the package.
arguments	string	no	–	–	Args.

---

MsiPackageDependency

Pre-install dependency check.

Property	Type	Required	Default	Validators	Description
displayName	string	yes	–	required, min	Friendly name shown in UI/log.
namePattern	string (regex)	yes	–	required, min	Regex matched against installed apps' DisplayName.
minVersion	string	no	–	–	Minimum acceptable version.
detectionScript	string	no	–	valid path on disk	Custom PowerShell script (overrides default detection).
install	object (MsiPackageDependencyInstall)	no	–	–	How to auto-install if missing.

---

MsiPackageDependencyInstall

Property	Type	Required	Default	Validators	Description
winGet	object (MsiPackageDependencyInstallWinGet)	no	–	–	Install via WinGet.

---

MsiPackageDependencyInstallWinGet

Property	Type	Required	Default	Validators	Description
id	string	yes	–	required, min	WinGet package ID.
arguments	string	no	--accept-source-agreements --disable-interactivity --force --exact --source winget	–	Extra winget install arguments.

---

MsiUpdater

Background auto-updater service. Requires digitalSignature AND installDir under %ProgramFiles%/%ProgramFiles(x86)%.

Property	Type	Required	Default	Validators	Description
serviceName	string	yes	–	required, min	Windows service name.
serviceDisplayName	string	no	–	–	Display name.
serviceDescription	string	no	–	–	Description.
latestVersionDescriptor	object (MsiUpdaterLatestVersionDescriptor)	yes	–	required	How to fetch and parse "latest version" metadata.
scheduling	object (MsiUpdaterScheduling)	yes	–	required	When/how often to check.
notifications	object (MsiUpdaterNotifications)	yes	–	required	Notification rules.
logging	object (MsiUpdaterLogging)	no	{ "installerLogsRetentionDays": 30 }	–	Log retention.

---

MsiUpdaterLatestVersionDescriptor

Property	Type	Required	Default	Validators	Description
url	URL	yes	–	required, min, valid http url	GET endpoint over HTTPS.
versionMatcher	string (regex)	yes	–	required, min	Regex (one capture group) → latest version.
versionUrlMatcher	string (regex)	no	–	–	Regex → "what's new" URL.
installerUrlMatcher	string (regex)	yes	–	required, min	Regex → installer download URL.
checkSumMatcher	string (regex)	yes	–	required, min	Regex → SHA256 checksum.

---

MsiUpdaterScheduling

Property	Type	Required	Default	Validators	Description
enabled	boolean	yes	–	required	Master switch. Override at install: UPDATE_SCHEDULING_ENABLED.
initialDelay	integer (ms)	no	60000	–	Override: UPDATE_SCHEDULING_STARTUP_DELAY.
interval	integer (ms)	no	86400000 (24 h)	–	Override: UPDATE_SCHEDULING_INTERVAL.
retryInterval	integer (ms)	no	180000 (3 min)	–	Override: UPDATE_SCHEDULING_RETRY_INTERVAL.

---

MsiUpdaterNotifications

Property	Type	Required	Default	Validators	Description
enabled	boolean	yes	–	required	Toast notifications. Override: UPDATE_NOTIFICATIONS_ENABLED.
triggers	string[]	no	–	–	Process names whose launch triggers notification.

---

MsiUpdaterLogging

Property	Type	Required	Default	Validators	Description
installerLogsRetentionDays	integer	no	30	–	Override: UPDATE_LOGGING_INSTALLER_LOGS_RETENTION_DAYS.

---

MsixDeviceCapability

Hardware/device capability for an MSIX package.

Property	Type	Required	Default	Validators	Description
name	enum (see below)	yes	–	required	Friendly capability name.
devices	array of MsixDevice (max 1000)	no	–	max	Specific devices targeted.

name enum values: activity, bluetooth, humaninterfacedevice, location, lowLevel, microphone, optical, pointOfService, proximity, radios, serialcommunication, usb, webcam, wiFiControl.

---

MsixDevice

Property	Type	Required	Default	Validators	Description
id	string (max 512)	yes	–	required, min, max	Device identifier (e.g., vidpid:045E 02FE).
functions	array of MsixDeviceFunction (1-100 items)	yes	–	required, min, max	Functions exposed by the device.

---

MsixDeviceFunction

Property	Type	Required	Default	Validators	Description
type	string (max 100)	yes	–	required, min, max	The function type, e.g., name:keyboard.

---

MsixPackageDependency

★ NEW in 2.2.0. Dependency on a framework MSIX package (e.g., VCLibs, WinUI).

Property	Type	Required	Default	Validators	Description
name	string (3-50)	yes	–	required, min, max, unique name	The Identity/Name of the dependency package.
publisher	string (1-8192)	yes	–	required, min, max, valid distinguished names	The Identity/Publisher (RFC-1779 Distinguished Name).
minVersion	string	yes	–	required, min, valid version	Minimum version (Major.Minor.Build.Revision, Major > 0).

---

Psf

Package Support Framework configuration. See PSF.

Property	Type	Required	Default	Validators	Description
disable	boolean	no	false	–	Turn PSF off.
configFile	string	no	–	valid path on disk	Custom PSF config.json. Disables auto-detection of fixups.

If your fileSystemEntries already contains a file named config.json, PSF will not be enabled.

---

MsixInstallDialog

Property	Type	Required	Default	Validators	Description
primaryAccent	string (hex RGB)	no	–	–	Accent color.
appInstallerDataFilePath	string	no	–	valid path on disk	Custom MSIXAppInstallerData.xml for fully custom UX. Overrides primaryAccent and EULA URL.

---

End of reference

For prose explanations, gotchas, and examples for each capability, jump to the corresponding capability page. For an annotated end-to-end example, see Complete Example.