Type: Troubleshooting | Category: Umbraco Forms > Licensing | Tags: Umbraco Forms, license, license domains, subscription license, save changes
Product: Umbraco Forms | Version: All versions
How to Troubleshoot and Resolve Common License Issues in Umbraco Forms
When working with Umbraco Forms, you may encounter issues related to license installation or permissions. This guide provides troubleshooting steps and best practices to resolve these common problems.
Troubleshooting License File Issues
If you are experiencing issues with your license file, follow these steps:
Replace the License File: If restarting the web application does not resolve the issue, replace the old license file in the file system with the new one. Ensure the new license file is correctly installed. - After replacing the file, restart the web application to apply the changes. - For detailed instructions, refer to the Umbraco Forms Licensing Guide.
Restart the Website: If the license shows as successfully installed but does not function as expected, ensure you restart the website after validating the license. This step is crucial to complete the installation process.
Can't save domain changes to your license
If you can't save the domains on your Umbraco Forms license, check how the domains are entered and how many you've added.
Enter the domain name only. Leave out
https://,wwwand any trailing slash. For example, enterexample.com, nothttps://www.example.com/.Stay within the domains your license covers. A single Umbraco Forms license covers:
1 production domain, including all its subdomains and the
.localextension (for example,example.com.local)2 development or testing domains
You can't add more domains than this to one license. Each extra domain is a separate add-on purchase.
Save again after correcting the domain entries.
On a subscription license, you can change your domains free of charge. If you still can't save your changes, ask to talk to a human and our Support team will help.
Added a domain to your license, but it's still not recognized
If you've added a domain to your Umbraco Forms license and it still isn't recognized, check the following:
The domain is on your license. Confirm that every domain you need is listed on the license, including your production domain and any development, staging or QA domains. On a subscription license, you can reconfigure domains free of charge after purchase. On a one-off license, changing domains requires payment.
The license is installed and the site restarted. Make sure the license key or file is installed in your solution, then restart the site so the license is validated again.
The domain is one your license covers. A license automatically covers:
localhostall subdomains of your production domain (for example,
*.example.com)the
.localextension of your production domain (for example,example.com.local)
If several separate domains point to the same installation, each one needs its own additional domain on the license. Each additional domain includes 1 live domain and 2 development or testing domains. To buy one, contact the Umbraco sales team. Additional domain purchases can't be refunded.
If the domain is still not recognized after these checks, ask to talk to a human and our Support team will help.
Permissions and Access Requirements
In some cases, you may not have the necessary permissions to manage workflows or replace the license file. Here’s what you can do:
Involve a Developer: Actions such as replacing the license file or managing workflows require developer-level access to the hosting environment.
Verify Permissions: Ensure the person performing these actions has the correct permissions to make changes to the Umbraco Forms workflows.
General Best Practices
Always back up your current license file and configuration before making changes.
Follow the official documentation for any installation or configuration steps to avoid errors.
Ensure that the hosting environment meets all requirements for running Umbraco Forms.
By following these steps and best practices, you can effectively troubleshoot and resolve common license issues in Umbraco Forms.
Related Topics
AI + human generated. Last updated on November 17, 2026
