Skip to main content

How can I resolve licensing issues in Umbraco Forms, including 'trial mode', invalid licenses, and local validation?

Written by Joana Knobbe
Updated over a month ago

Resolving Licensing Issues in Umbraco Forms: Trial Mode, Invalid Licenses, and Validation

Licensing issues in Umbraco Forms can arise due to various reasons, such as misleading trial mode messages, invalid license files, or local setups showing a 'trial' or 'unlicensed' status. This article provides comprehensive troubleshooting guidelines to address these situations.

Common Issue: “Empty due to Umbraco Forms in trial mode” Message

In some cases, Umbraco Forms may display the message "Empty due to Umbraco Forms in trial mode," even though a valid license is installed. This can be misleading. To confirm whether your license is functioning properly:

  1. Open a form with submitted responses.

  2. Navigate to the Forms Entries dashboard to check if the entries are visible.

If entries are visible, your license is active and functioning correctly, despite the misleading message.

Resolving Invalid License File Issues

If your Umbraco Forms license file is showing as invalid, ensure that the correct license file is being used, and follow these steps to resolve the issue:

  1. Obtain the proper license file that matches the domain for which you have purchased the license.

  2. Copy the license file to the following location: /umbraco/Licenses.

  3. Replace any existing license file if it is no longer valid or correct.

  4. Restart the application pool (or recycle the app/website) to trigger a license validation check.

By performing the above steps, the Umbraco Forms license should be recognized as valid.

Validating Licenses in Umbraco Cloud or Backoffice

For setups using Umbraco Cloud or when working locally with Forms showing as 'unlicensed' or 'trial', you can validate your license through the backoffice:

  1. Navigate to the Licenses tab in the backoffice at /umbraco/section/settings/dashboard/licenses.

  2. Validate the Forms license from the dashboard. Note that the Licenses tab appears only when licenses are configured (e.g., via appsettings).

Validating the license through the backoffice resolves issues where the Forms appear to be in an unlicensed or trial state.


By using the steps outlined above, you can successfully troubleshoot and resolve licensing issues in Umbraco Forms, ensuring it operates without interruptions. If problems persist after following these instructions, you may need to contact Umbraco support for further assistance.

Related Topics

  • Licensing Overview for Umbraco Products

  • Configuring Licenses for Additional Domains

  • Troubleshooting Common Umbraco Forms Errors

Did this answer your question?