Troubleshooting: Theme File "Has Not Been Pre-Compiled, and Cannot Be Requested" Error

Version Affected: 26.2 and later
 
 

Overview

When requesting a custom theme, the site may return an error similar to: The file '/SecureAuthXX/Themes/Custom_Theme_Name/Your_theme.Master' has not been pre-compiled, and cannot be requested.

Cause

This is caused by the precompiledApp updatable="false" setting, combined with a custom theme in use.

Resolution:

Every realm folder has a PrecompiledApp.config file at its root. Open it in a text editor and set updatable to true:

<precompiledApp version="2" updatable="true" />

Note: restart the application pool or IIS for the change to take effect.

Special Considerations

For better performance, it is recommended to keep updatable="false" where possible — use the default theme and leave updatable="false" in PrecompiledApp.config if you can. If you need to update multiple realms, use the Updater's Copy Tool to replace the file across them rather than editing each one by hand.


 

SecureAuth Knowledge Base Articles provide information based on specific use cases and may not apply to all appliances or configurations. Be advised that these instructions could cause harm to the environment if not followed correctly or if they do not apply to the current use case.

Customers are responsible for their own due diligence prior to utilizing this information and agree that SecureAuth is not liable for any issues caused by misconfiguration directly or indirectly related to SecureAuth products.