Customise Script Templates
Script Templates control how Robopack wraps your app installations using the PowerShell App Deployment Toolkit (PSADT). By creating custom templates, you can configure welcome dialogs, deferrals, progress notifications, completion messages, and more — and have them apply consistently to every app that uses the template.
What you'll need
- Organisation Administrator or Package Writer permissions in Robopack
Step-by-Step Guide
1. Navigate to Settings > Script Templates
In the Robopack dashboard, go to Settings > Script Templates. You'll see a list of your existing templates along with the shared default templates.
There are two sections on this page:
- Package script templates — the templates you can select when building packages and flows
- Installation scripts — the underlying PSADT script versions available (e.g. v3.10.2, v4.1.8)
2. Create a new template
Click Edit template or create a new one. You'll need to configure:
| Field | Description |
|---|---|
| Name | A descriptive name (e.g. "Standard - Allow Deferral", "Marketing - 6 Deferrals") |
| Installation script | The PSADT version to use (v3.10.2, v4.1.5, v4.1.7, v4.1.8, etc.) |
3. Choose your PSADT version
| Version | Notes |
|---|---|
| PSADT v3.x | The current default. Well-established and widely tested. |
| PSADT v4.1.x | Newer version with updated commands and features. |
The commands supported by PSADT have changed between v3 and v4. If you have Custom App Settings that use PSADT commands, make sure you have migrated them before switching to a v4-based template.
4. Configure template options
Company name
Set your organisation name. This appears in PSADT dialog titles shown to end users.
Welcome dialog
The welcome dialog appears when an installation starts. It can notify users that an app is being installed and optionally prompt them to close conflicting applications.
| Setting | Description |
|---|---|
| Show welcome dialog | Enable or disable the welcome dialog |
| Only if there are apps to close | Only show the dialog if the user has apps running that are listed in the Apps to close setting of the app's Custom App Settings |
| Allow deferrals | Let users postpone the installation. Set the number of times they can defer (e.g. 3, 6). |
| Don't allow deferrals | Force the installation immediately |
| Custom text | Add a custom message to the welcome dialog |
Progress dialog
Enable a progress dialog to show users that an installation is in progress. You can set a custom progress message (e.g. "App Install In Progress").
Install complete dialog
Show a dialog when the installation finishes. You can customise:
- Title — the dialog heading (e.g. "Finished!")
- Body text — the message shown (e.g. "Well done, this app is installed!")
Remove desktop shortcuts
When enabled, Robopack removes any desktop shortcuts created by the installer. This keeps desktops clean and is enabled by default on most templates.
Custom icon
By default, dialogs display the icon of the app being installed. You can upload a custom icon (recommended size: 256x256px) to show your company logo or a standard image instead.
Force user interactive (ServiceUI)
For machine-scope deployments where PSADT dialogs need to be visible to the logged-in user, enable Force user interactive. This uses ServiceUI to ensure dialogs appear in the user's session.
5. Configure logging (optional)
You can customise where PSADT writes log files:
| Setting | Default | Description |
|---|---|---|
| Log file directory | PSADT default | Where installation logs are written |
| Log file directory (MSI installers) | PSADT default | Separate log path for MSI installations |
For example, many organisations set this to $envWinDir\Logs\Software to centralise logs.
6. Save and use your template
Save the template. It will now appear as an option whenever you:
- Analyze and Build a package from Instant Apps
- Create a Robopatch Flow
- Convert a custom package
You can set any template as the Default so it's automatically selected for new packages.
Example templates
Here are some common template configurations:
| Template name | Welcome dialog | Deferrals | Complete dialog | Notes |
|---|---|---|---|---|
| Standard - No Deferral | Yes (only if apps to close) | No | No | Quick, non-intrusive |
| Standard - Allow Deferral | Yes (only if apps to close) | Yes (3 times) | No | Gives users flexibility |
| Marketing - 6 Deferrals | Yes | Yes (6 times) | No | For less technical users |
| Full Notification | Yes | Yes (3 times) | Yes ("Installation complete") | Maximum user visibility |
| Silent | No | No | No | No user interaction at all |
What's next?
- Script Templates feature overview
- Deploying Your First App — uses the default PSADT template
- Deploying Custom Apps