Skip to main content

How can I troubleshoot and resolve common license issues in Umbraco Forms?

Written by Joana Knobbe

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:

  1. 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.

  2. 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.

  1. Enter the domain name only. Leave out https://, www and any trailing slash. For example, enter example.com, not https://www.example.com/.

  2. Stay within the domains your license covers. A single Umbraco Forms license covers:

    • 1 production domain, including all its subdomains and the .local extension (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.

  3. 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:

  1. 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.

  2. 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.

  3. The domain is one your license covers. A license automatically covers:

    • localhost

    • all subdomains of your production domain (for example, *.example.com)

    • the .local extension 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

Did this answer your question?