For the complete documentation index, see llms.txt. This page is also available as Markdown.

Licensing

Umbraco Commerce is a commercial product. You can run Umbraco Commerce unrestricted locally without the need for a license. Running Umbraco Commerce in the public domain will display a warning banner in the backoffice and will limit the maximum number of orders to 20. To remove these restrictions, you'll need to have a valid license.

How does it work?

Licenses are sold per Umbraco installation. This means one license covers a single Umbraco database and its associated web project.

While the license is sold per installation, it is configured on a domain basis. This allows the Umbraco licensing server to verify that the backoffice is being accessed from an authorized environment.

The licenses are not tied to a specific product version. They work across all versions of the related product.

Example License Configuration

When you purchase a license, you define one production domain (which includes all its subdomains) and up to two development or testing domains.

For a license configured for mysite.com, with development domains devdomain.com and devdomain2.com, the following are covered:

  • Local Development: localhost, *.local, and *.test.

  • Production: mysite.com and all subdomains (for example, www.mysite.com, shop.mysite.com).

  • Staging/QA: Your two specifically registered domains, such as devdomain.com and devdomain2.com.

Only one license per Umbraco installation is allowed.

What does a license cover?

There are a few differences as to what the licenses cover:

  • A single license covers the installation of Umbraco Commerce in 1 production backoffice domain, as well as in any requested development domains.

  • The production domain includes all subdomains (e.g. *.mysite.com).

  • The development domains work with or without the www subdomain.

  • The license allows for an unlimited number of orders.

  • The license also includes localhost and *.local as a valid domain.

If you have multiple backoffice domains pointing at the same installation, you have the option to purchase and add additional domains to your license.

This is an add-on domain for existing licenses. Refunds will not be given for this product.

Purchasing your license

You can look at the pricing, features, and purchase a license on the Umbraco Commerce page. A member of the sales team will manage this process. You will need to provide all domains you wish to have covered by the license such as primary and development/staging/QA domains. You should then receive a license code to be installed in your solution.

Add additional domains

If you require to add addition domains to the license, reach out the sales team with your request and they will manage this process.

Configuring your license

Once you've purchased your license with the correct domains, you are ready to configure the license key on your Umbraco installation.

The license key should be added to your configuration using product ID: Umbraco.Commerce.

For detailed instructions on how to install and configure your license, including version-specific examples and additional configuration options, see the Configure Licenses article.

Last updated

Was this helpful?