Home / / Use Kontainer With Umbraco

Use Kontainer With Umbraco

PIM Premium+ plans DAM

Kontainer's Umbraco plugin adds a media picker to the Umbraco back office, giving editors direct access to approved assets from Kontainer while building and maintaining website content. Follow the instructions below to set it up and start using it.

Note: Before using Kontainer in Umbraco, you need to install the Plugin. Find out more here. 

See plugin resources on NuGet and visit the Kontainer integration page for more information.

Still running an older Umbraco 8 site? Use the legacy plugin and guide on Our Umbraco instead — see the note at the bottom of this article.

How-To: Install and Set Up Kontainer in Umbraco

Install the plugin

  1. Install the package from NuGet: dotnet add package Kontainer.Umbraco (or via the NuGet Package Manager Console: Install-Package Kontainer.Umbraco)
  2. Build and restart your Umbraco application. The plugin's back-office files are automatically copied into your project.

Add the Kontainer Media Picker

  1. Open the Umbraco back office and go to Settings
  2. Create a new Data Type
  3. Select Kontainer Media Picker as the property editor
  4. Enter your Kontainer domain and choose your selection settings (single or multiple, minimum/maximum number of items)
  5. Add the Data Type to the relevant Document Type

Once this is done, editors will see the Kontainer picker on any content page that uses that Document Type.

For questions and information about the Umbraco Plugin, please get in touch at support@kontainer.com

How-To: Use Kontainer with Umbraco

  1. Open the page you are working on in Umbraco
  2. Find the Kontainer Media Picker field under the Content tab
  3. Open the picker to browse your Kontainer library
  4. Select the image or file you need (select multiple items if the field allows it)
  5. Confirm your selection to add it to the page

For questions and information about the Umbraco plugin, please get in touch at support@kontainer.com

For Umbraco 8 (legacy)

If your site is still on Umbraco 8, use the older plugin instead:

  1. Install it via the legacy package on Our Umbraco
  2. Open the page you are working on in Umbraco
  3. Find Kontainer under the Content tab and click the plus button to open it
  4. Navigate to the image you need
  5. Either hover and click Download to fetch the original file, or select the image and choose Use → Use Custom to resize it before use