This article covers the topic of how to install the Screen9 Plugin for Optimizely CMS (formerly Episerver) version 12. For instructions how to install Screen9 Plugin on the previous version of Episerver see article Episerver - Install the Screen9 Episerver Plugin (Episerver 9, 10, 11).

In order to install the Screen9 Plugin you need administrator privileges on your Optimizely CMS and Screen9 account.

Install NuGet in Visual Studio

Right click your Optimizely project and choose "Manage NuGet Packages...".

Change the package source to "nuget.org" and search for "Screen9.Optimizely.CMS.UI" package.

After selecting the correct version of the plugin, press Install and OK to proceed.

Add Screen9 configuration

Create a REST API Access token with Read, Write and Upload privileges. We recommend setting the access level to Public in order to only display approved media, however if users are allowed to upload media from Optimizely CMS the token must be Full otherwise the video will not be visible after upload. More details on how to create a REST API Access token can be found in this article.

Then add the following options to appsettings.json:

    "Screen9Settings": {
        "AccountId": "123456",
        "RestApiToken": "Token_value"
    }

Enable Screen9 integration

Screen9 is added to the site by including it in the service configuration. Screen9.Optimizely.Extensions contains extension methods to easily include the default Screen9 functionality.

In your site's service configuration, add the following line:

services.AddScreen9Integration(_configuration);

Use Screen9 videos

The videos from Screen9 platform are visible in the "Screen9 Video" asset pane: