Described option for using understores in product keys when configuring product licenses with environment variables.

AndyButland · AndyButland · commit 38e497a7bb7c · 2024-12-12T21:22:01.000+01:00
diff --git a/10/umbraco-commerce/installation/licensing-model.md b/10/umbraco-commerce/installation/licensing-model.md
@@ -67,6 +67,14 @@ Once you have received your license code it needs to be installed on your site.
 }
 ```
 
+{% hint style="info" %}
+If using environment variables rather than a JSON file for your configuration you may run into issues with the periods used in the product key.  If so, an underscore can be used instead:
+
+```json
+"Umbraco_Commerce": "YOUR_LICENSE_KEY"
+```
+{% endhint %}
+
 ### Verify the license installation
 
 You can verify that your license is successfully installed by logging into your project's backoffice and navigating to the settings section. Here you will see a licenses dashboard which should display the status of your license.
diff --git a/10/umbraco-ui-builder/installation/licensing-model.md b/10/umbraco-ui-builder/installation/licensing-model.md
@@ -67,6 +67,14 @@ Once you have received your license code it needs to be installed on your site.
 }
 ```
 
+{% hint style="info" %}
+If using environment variables rather than a JSON file for your configuration you may run into issues with the periods used in the product key.  If so, an underscore can be used instead:
+
+```json
+"Umbraco_UIBuilder": "YOUR_LICENSE_KEY"
+```
+{% endhint %}
+
 ### Verify the license installation
 
 You can verify that your license is successfully installed by logging into your project's backoffice and navigating to the settings section. Here you will see a license dashboard which should display the status of your license.
diff --git a/13/umbraco-commerce/installation/the-licensing-model.md b/13/umbraco-commerce/installation/the-licensing-model.md
@@ -67,6 +67,14 @@ Once you have received your license code it needs to be installed on your site.
 }
 ```
 
+{% hint style="info" %}
+If using environment variables rather than a JSON file for your configuration you may run into issues with the periods used in the product key.  If so, an underscore can be used instead:
+
+```json
+"Umbraco_Commerce": "YOUR_LICENSE_KEY"
+```
+{% endhint %}
+
 ### Verify the license installation
 
 You can verify that your license is successfully installed by logging into your project's backoffice and navigating to the settings section. Here you will see a license dashboard which should display the status of your license.
diff --git a/13/umbraco-deploy/installation/install-configure.md b/13/umbraco-deploy/installation/install-configure.md
@@ -292,6 +292,14 @@ For example, in `appsettings.json`:
     }
 ```
 
+{% hint style="info" %}
+If using environment variables rather than a JSON file for your configuration you may run into issues with the periods used in the product key.  If so, an underscore can be used instead:
+
+```json
+"Umbraco_Deploy_OnPrem": "YOUR_LICENSE_KEY"
+```
+{% endhint %}
+
 Umbraco Cloud projects use a license file placed in the `/umbraco/Licenses` folder that is provided when your project is created.
 
 Read more about the [Umbraco Deploy licensing model](../installation/the-licensing-model.md).
diff --git a/13/umbraco-deploy/installation/the-licensing-model.md b/13/umbraco-deploy/installation/the-licensing-model.md
@@ -67,6 +67,14 @@ For example, in `appsettings.json`:
     }
 ```
 
+{% hint style="info" %}
+If using environment variables rather than a JSON file for your configuration you may run into issues with the periods used in the product key.  If so, an underscore can be used instead:
+
+```json
+"Umbraco_Deploy_OnPrem": "YOUR_LICENSE_KEY"
+```
+{% endhint %}
+
 Umbraco Cloud projects use a license file placed in the `/umbraco/Licenses` folder that is provided automatically when your project is created.
 
 ## Validating the license
diff --git a/13/umbraco-engage/installation/licensing.md b/13/umbraco-engage/installation/licensing.md
@@ -73,6 +73,15 @@ Once you have received your license code it needs to be installed on your site.
 }
 ```
 
+{% hint style="info" %}
+If using environment variables rather than a JSON file for your configuration you may run into issues with the periods used in the product key.  If so, an underscore can be used instead:
+
+```json
+"Umbraco_Engage": "YOUR_LICENSE_KEY"
+```
+{% endhint %}
+
+
 ### Verify the license installation
 
 You can verify that your license is successfully installed by logging into your project's backoffice and navigating to the settings section. Here you will see a license dashboard which should display the status of your license.
diff --git a/13/umbraco-ui-builder/installation/licensing-model.md b/13/umbraco-ui-builder/installation/licensing-model.md
@@ -67,6 +67,14 @@ Once you have received your license code it needs to be installed on your site.
 }
 ```
 
+{% hint style="info" %}
+If using environment variables rather than a JSON file for your configuration you may run into issues with the periods used in the product key.  If so, an underscore can be used instead:
+
+```json
+"Umbraco_UIBuilder": "YOUR_LICENSE_KEY"
+```
+{% endhint %}
+
 ### Verify the license installation
 
 You can verify that your license is successfully installed by logging into your project's backoffice and navigating to the settings section. Here you will see a license dashboard which should display the status of your license.
diff --git a/14/umbraco-commerce/getting-started/the-licensing-model.md b/14/umbraco-commerce/getting-started/the-licensing-model.md
@@ -69,6 +69,14 @@ Once you have received your license code it needs to be installed on your site.
 }
 ```
 
+{% hint style="info" %}
+If using environment variables rather than a JSON file for your configuration you may run into issues with the periods used in the product key.  If so, an underscore can be used instead:
+
+```json
+"Umbraco_Commerce": "YOUR_LICENSE_KEY"
+```
+{% endhint %}
+
 ### Verify the license installation
 
 You can verify that your license is successfully installed by logging into your project's backoffice and navigating to the settings section. Here you will see a license dashboard which should display the status of your license.
diff --git a/14/umbraco-deploy/installation/install-configure.md b/14/umbraco-deploy/installation/install-configure.md
@@ -292,6 +292,14 @@ For example, in `appsettings.json`:
     }
 ```
 
+{% hint style="info" %}
+If using environment variables rather than a JSON file for your configuration you may run into issues with the periods used in the product key.  If so, an underscore can be used instead:
+
+```json
+"Umbraco_Deploy_OnPrem": "YOUR_LICENSE_KEY"
+```
+{% endhint %}
+
 Umbraco Cloud projects use a license file placed in the `/umbraco/Licenses` folder that is provided when your project is created.
 
 Read more about the [Umbraco Deploy licensing model](../installation/the-licensing-model.md).
diff --git a/14/umbraco-deploy/installation/the-licensing-model.md b/14/umbraco-deploy/installation/the-licensing-model.md
@@ -69,6 +69,14 @@ For example, in `appsettings.json`:
     }
 ```
 
+{% hint style="info" %}
+If using environment variables rather than a JSON file for your configuration you may run into issues with the periods used in the product key.  If so, an underscore can be used instead:
+
+```json
+"Umbraco_Deploy_OnPrem": "YOUR_LICENSE_KEY"
+```
+{% endhint %}
+
 Umbraco Cloud projects use a license file placed in the `/umbraco/Licenses` folder that is provided automatically when your project is created.
 
 ## Validating the license
diff --git a/14/umbraco-ui-builder/installation/licensing-model.md b/14/umbraco-ui-builder/installation/licensing-model.md
@@ -65,10 +65,19 @@ Once you have received your license code it needs to be installed on your site.
         "Products": {
             "Umbraco.UIBuilder": "YOUR_LICENSE_KEY"
          }
-  }    
+  }
 }
 ```
 
+
+{% hint style="info" %}
+If using environment variables rather than a JSON file for your configuration you may run into issues with the periods used in the product key.  If so, an underscore can be used instead:
+
+```json
+"Umbraco_UIBuilder": "YOUR_LICENSE_KEY"
+```
+{% endhint %}
+
 ### Verify the license installation
 
 You can verify that your license is successfully installed by logging into your project's backoffice and navigating to the settings section. Here you will see a license dashboard which should display the status of your license.
diff --git a/15/umbraco-commerce/getting-started/the-licensing-model.md b/15/umbraco-commerce/getting-started/the-licensing-model.md
@@ -69,7 +69,13 @@ Once you have received your license code it needs to be installed on your site.
 }
 ```
 
+{% hint style="info" %}
+If using environment variables rather than a JSON file for your configuration you may run into issues with the periods used in the product key.  If so, an underscore can be used instead:
 
+```json
+"Umbraco_Commerce": "YOUR_LICENSE_KEY"
+```
+{% endhint %}
 
 ### Verify the license installation
 
diff --git a/15/umbraco-deploy/installation/install-configure.md b/15/umbraco-deploy/installation/install-configure.md
@@ -292,6 +292,14 @@ For example, in `appsettings.json`:
     }
 ```
 
+{% hint style="info" %}
+If using environment variables rather than a JSON file for your configuration you may run into issues with the periods used in the product key.  If so, an underscore can be used instead:
+
+```json
+"Umbraco_Deploy_OnPrem": "YOUR_LICENSE_KEY"
+```
+{% endhint %}
+
 Umbraco Cloud projects use a license file placed in the `/umbraco/Licenses` folder that is provided when your project is created.
 
 Read more about the [Umbraco Deploy licensing model](../installation/the-licensing-model.md).
diff --git a/15/umbraco-deploy/installation/the-licensing-model.md b/15/umbraco-deploy/installation/the-licensing-model.md
@@ -69,6 +69,14 @@ For example, in `appsettings.json`:
     }
 ```
 
+{% hint style="info" %}
+If using environment variables rather than a JSON file for your configuration you may run into issues with the periods used in the product key.  If so, an underscore can be used instead:
+
+```json
+"Umbraco_Deploy_OnPrem": "YOUR_LICENSE_KEY"
+```
+{% endhint %}
+
 Umbraco Cloud projects use a license file placed in the `/umbraco/Licenses` folder that is provided automatically when your project is created.
 
 ## Validating the license
diff --git a/15/umbraco-ui-builder/installation/licensing-model.md b/15/umbraco-ui-builder/installation/licensing-model.md
@@ -65,10 +65,18 @@ Once you have received your license code it needs to be installed on your site.
         "Products": {
             "Umbraco.UIBuilder": "YOUR_LICENSE_KEY"
          }
-  }    
+  }
 }
 ```
 
+{% hint style="info" %}
+If using environment variables rather than a JSON file for your configuration you may run into issues with the periods used in the product key.  If so, an underscore can be used instead:
+
+```json
+"Umbraco_UIBuilder": "YOUR_LICENSE_KEY"
+```
+{% endhint %}
+
 ### Verify the license installation
 
 You can verify that your license is successfully installed by logging into your project's backoffice and navigating to the settings section. Here you will see a license dashboard which should display the status of your license.
