UmbraCare LOGO

Dedicated Media Folder Documentation

Key notes:#

  • Supports Umbraco v8, v9, v10, v11, v12 and v13.
  • Works on .NET Framework 4.7.2+ and .NET Core.
  • You can install the package in one of two ways: via NuGet repository or Umbraco Marketplace (Umbraco website > back-office > Packages).
  • It is recommended to install the package via the NuGet repository.
  • This is not a free package. After installation, you will use the limited trial version until you buy a license. 
  • You can use the full-featured version on localhost only.
  • The folder will be permanently associated with the node in the Content section, even if the node will be renamed or moved (full version only).
  • When you delete a content node, then the dedicated folder will also be moved to the trash (full version only).

 

Dedicated Media Folder License Project

Dedicated Media Folder license file in Umbraco v13 project

How to activate the license#

  • You need to place the license file UmbraCare.DedicatedMediaFolder.lic in the default licensing directory.
  • After placing the license file in the right directory you need to restart the application to activate this package.

The default license directory path: "~/umbraco/Licenses"

Basically, license should be installed in the same way as license for the Umbraco Forms.

This way you can keep all licenses in a common folder.

Reference: https://docs.umbraco.com/umbraco-forms/installation/the-licensing-model#installing-your-license

Make sure the license is being placed automatically in the right folder during the deployment process of your application.

Custom license directory#

If you need to keep your licences under any other custom directory then you can change the default path by changing the configuration as below:

"Umbraco": {
    "Licensing": {
      "Directory": "~/umbraco/Licenses"
    }
}

License Activation FAQ

1. My license is not working. What should I check first?

Ensure the license file UmbraCare.DedicatedMediaFolder.lic is placed in the correct directory in your deployed environment:

  • Default path: ~/umbraco/Licenses (relative to your deployed website root).

  • Confirm that the license file is present on the production server after deployment.

  • Restart the application after adding the license file.

2. I added the license file, but the package is still in trial mode. What’s wrong?

Check the following:

  • The license file must be placed in the deployed environment, not only in your local development setup.

  • Verify that your CI/CD pipeline (e.g., Azure DevOps, GitHub Actions) includes the license file in the deployment artifacts.

  • Confirm the file is not ignored by .gitignore or deployment scripts.

3. Can I change the default license directory?

Yes, you can customize the license path in your appsettings.json file:

"Umbraco": {
  "Licensing": {
    "Directory": "~/custom/path/to/licenses"
  }
}

Ensure the license file is placed in this custom directory on your production server.

4. How can I ensure the license file is always deployed?

  • Add the license file to your website project.

  • If using a custom deployment pipeline, ensure it includes the license file.

  • Treat the license file similarly to Umbraco Forms licenses.

5. Does the license file need to be present on all environments (e.g., staging, production)?

Yes, the license file is environment-specific and must be present in each environment where you want the full version to work.

6. I deployed via CI/CD, and the license is missing. How do I prevent this?

  • Include the license file in your version control system if your policies allow it.

  • Alternatively, manually upload the license file to the appropriate directory on the server post-deployment.

7. I still see the trial version warning after following the steps. What now?

  • Double-check the path and permissions of the license file on the server.

  • Restart the application after placing the license.

  • Confirm that the license file is valid and not corrupted.

8. Can I use one license file across multiple sites?

Yes, one license file can cover multiple domains if specified in the license agreement. Ensure your license supports this feature.

9. What happens if I forget to deploy the license file?

The package will operate in trial mode, limiting some features (e.g., no automatic folder protection, no restore on delete).

10. Is the license file sensitive data? Should I keep it secure?

While the license file itself is not highly sensitive, it is best practice to treat it with care:

  • Avoid public repositories.

  • Limit access to authorized personnel.

  • Secure your deployment pipelines.

11. Does the package collect any telemetry data or require an internet connection?

No, the Dedicated Media Folder package does not collect any telemetry data and does not require an internet connection to activate or validate the license. The license validation is entirely offline, and your data privacy is fully respected.

Still Need Help?

If you continue to experience issues, contact our support team at support@umbracare.net.

EDITOR'S PICK

↑ Top ↑