Embed Player Syndication Engine

Partner sites can easily embed your videos directly on their platforms using the embed player option in ViewLift's web player.

Enabling Embed Player 

1. Toggle on the EMBED PLAYER feature in AppCMS > Settings > Features.
2. In the Add Domains to Allow for Embed text box, type and enter the partner domains you want to allow to allow the embed feature.
   Type only the base domain of the website like "example.com" without any subdomains (www) or protocols (https). This will whitelist the domain and allow your third parties to embed ViewLift's player on their websites. It is also a best practice not to include any permalinks to the domain you are whitelisting, as that will not work.
   Note: To whitelist all domains,  type `*`. This will allow anyone to use your iframe codes on external websites.
3. Enable the Show Embed button on Player toggle. This creates an embed code snippet that partner sites can put into their website's HTML. See the screenshot for an example.

You can also find the embed code of a video under the EMBED section of a video object page. 

Within the embed code, you can adjust size and behavior using various properties such as width, height, scrolling, and others. 

Finally, click the Save button at the bottom of the AppCMS > Settings tab to publish the embed settings. The settings are cached for 5 hours, so after you have made changes please wait for at least 5 hours. 

Allow embedding SVOD content

Embedding SVOD content typically requires viewers of your partner sites to log in/sign up through your ViewLift website. See an example: 

If you want to skip the login, add the domain names of your partner sites to the Add Domains to Bypass Entitlement list. ViewLift's Identity API handles entitlement checks and if a domain is whitelisted, lets it bypass the SVOD / Free with email-required plans linked to SVOD assets. Remove the bypass entitlement if you want to put back the login wall.

Troubleshooting

Here are some specific troubleshooting issues that you may encounter when embedding iFrames, and their solutions:

- Make sure that the videos you want to embed are published and live.

- If you are seeing the error message "This content is not available in your area", it may be because of licensing or geo-restrictions. Please check the content detail page of the videos that are giving you the error to see if they are available in your region. Also, if a stream is on http (typically, live streams) and the whitelisted domain is on HTTPS, then the browser may not load the player.

- You can only whitelist domains to embed the player. There are no checks at the IP level. 

- The embed player feature works only on the web player. The code won't show on apps.

- Embedding contents attached with the "Email Required" Free Plans is similar to bypassing the SVOD entitlement check. Add the partner domain name to the Add Domains to Bypass Entitlement list to skip the email prompt over the content.