Customizations

On this page:

Enabling customization allows you to save custom pages in an existing custom web_root directory at PowerSchool\data\custom\web_root. The custom web_root directory contains the same folder structure as the stock, non-custom PowerSchool web_root at PowerSchool\application\components\powerschool-core-{version_number}\system\server\resources\web_root.

To use custom pages and files, enable customization and store your custom pages and files in the appropriate subdirectory of the custom web_root. When PowerSchool retrieves a page or file to display, it first checks the custom web_root directory and directory structure. If found in the custom web_root directory, the custom page loads. If it is not found in the custom web_root directory, the page or file loads from the standard PowerSchool web_root directory. Disable customization to ignore the custom web_root directory and simply load pages and files from the standard PowerSchool web_root directory.

Note: Any custom page placed in the standard web_root will be overwritten when you update PowerSchool. Be sure to store such pages in the custom web_root.
Updating PowerSchool may cause the standard and custom web roots to differ in structure. For example, if a folder related to new functionality is created in the standard web_root when updating the core PowerSchool application on your server, a folder of the same name in the same location needs to be created in the custom web_root before you can store any custom pages related to that new function. If necessary, manually add or remove folders from your custom web_root to mirror the standard web_root.

Enable Customization

1. On the start page, choose System under Setup in the main menu. 
2. Under Server, click System Settings.
3. Click Customization. 
4. Select the Customization Enabled checkbox to prevent overwriting custom pages on your server when updating PowerSchool.
5. Click Submit. 

Disable Customization

1. On the start page, choose System under Setup in the main menu. 
2. Under Server, click System Settings. 
3. Click Customization. 
4. Deselect the Customization Enabled checkbox.
   Note: If you have installed a plugin that requires customizations to be enabled, deselecting the checkbox will also disable the associated plugin. For more information, see Enable Plugins.
5. Click Submit.