App Templates
The App Templates page lets you customize how applications appear throughout the dashboard. Every application has a built-in definition with a default label, description, and display settings. The template editor lets you override any of these fields to tailor the dashboard to your preferences.
Admin only
App Templates requires admin privileges (admin.settings.update permission). Navigate to System > App Templates from the sidebar.
Display only
Changes to app templates affect how applications appear in the dashboard — their labels, descriptions, and navigation links. They do not change how applications function, their configuration, or their installed paths.
Key features
🏷️ Custom Labels
Change the display name of any application shown in the dashboard sidebar and app panels
📝 Custom Descriptions
Write your own descriptions for applications as they appear in the catalog and app panels
🔗 Custom URLs
Set a custom launch URL that overrides the default application URL in Quick Nav and app controls
🧭 Navigation Settings
Control how applications appear in the Quick Nav sidebar and other navigation elements
🔄 Reset to Defaults
Restore any customized template back to its built-in defaults with a single action
📦 Full Catalog
Browse and customize templates for all 69+ application definitions
Browsing templates
The main view displays a searchable table of all application templates. Each row shows the application name, current display label, and whether any customizations have been applied. Use the search field to quickly find a specific application.
Click on any application to open the template editor.
Template editor
The template editor lets you customize the following fields for each application:
| Field | What it controls |
|---|---|
Label | The display name shown in the sidebar, app panels, and other navigation elements |
Description | The text description shown in the application catalog and detail views |
Display mode | How the application is presented in the dashboard interface |
Navigation settings | How the application appears in Quick Nav and application menus |
Custom URL | A custom launch URL that overrides the default application web path |
The editor shows a preview of your changes so you can see how the application will appear before saving.
How overrides work
App Templates use a defaults-in-code, overrides-in-database pattern:
- Every application has a built-in definition with default values
- When you customize a field, the override is stored in the database
- The dashboard merges your overrides with the defaults, showing your values where they exist and falling back to defaults for fields you have not changed
- Resetting a template removes the database overrides and returns to the built-in defaults
Resetting templates
To reset a customized application template back to its defaults, open the template editor and use the reset action. This removes all overrides for that application — the label, description, and all other fields revert to their built-in values.
Best practices
Do
- Use custom labels to match the names your team uses internally — for example, rename 'qBittorrent' to 'Torrents' if that is more intuitive for your users
- Set custom URLs when your applications are accessible at non-standard paths or external domains
- Review the help modal in the editor to understand the override system before making changes
- Use descriptive labels that help your users find the right application quickly
Don't
- Don't confuse template changes with application configuration — templates only affect display, not behavior
- Don't set custom URLs to invalid addresses — users will get errors when clicking the application link
- Don't customize templates for applications that are not installed — the changes will have no visible effect until the application is installed
FAQ
Related pages
Join the Community
Media server operators sharing configs, getting support, and shaping the future of QuickBox Pro.