[object Object] Icon

Learn how to create, start, manage and modify Encodings

[object Object] Icon

Learn how to create, start, manage and modify Players

[object Object] Icon

Learn how to create, start, manage and modify Analyticss

Docs Home
User shortcuts for search
Focus by pressing f
Hide results by pressing Esc
Navigate via   keys

Mon Jul 25 2022

How does player licensing work?

The Bitmovin Player uses a simple licensing workflow to enable playback across your applications and platforms. In this article, we’ll be covering three topics - How to get started with licensing, licensing use cases, and a FAQ to cover common questions.

How to Get Started with Licensing

  1. Let’s get started! The first step is to log in to your Bitmovin dashboard via Bitmovin Dashboard.
  2. Next, locate the product links on the lefthand side navigation menu. Click Player and then Licenses.


  3. You will now see your available licenses for the Bitmovin Player. There are 4 important pieces of information to note - Name, Key, Impressions, and Maximum Impressions. The Name is the specified naming convention you designate when you create the license. When your Bitmovin account is created, your first license will be named default-license. The Key is your specified license key that is used to authorize your application or platform to use the Bitmovin Player. Finally, Impressions and Maximum Impressions are the total impressions used and the allotted impressions for that specific license.
  4. Next, copy your license key under the Key column. lic2 Now click the license name under the Name column. You will now see a section titled Domains / Package Names / Bundle Identifiers.

  5. For the player to be used on a domain different from localhost, you will have to allow-list the domain of your website for which you want to enable the player. This is a security mechanism and protects your license from being used elsewhere.

  6. Finally, using the license key you copied in Step 4, follow our Player Web Getting Started Tutorial to get your first Bitmovin Player up and running: Bitmovin Docs - Player Web SDK Getting started lic3

Licensing Use Cases

Bitmovin’s customers typically fall under 3 different uses when setting up their licenses. We’ll briefly cover each use case and provide a scenario where that particular use case might be used. These use cases are simply guidelines to help you determine the best licensing setup for you, but your company has the power to combine any of the below use cases or create a new type of setup tailored to your product.

1. One player license for everything

Common Scenario You are a smaller company that doesn’t care about development mixing with production impressions, a smaller amount of player impressions per month, and/or you only have a couple of videos being streamed on the player.

2. One player license for each brand/platform

Common Scenario Your company has multiple brands/platforms that you would like to separately track impressions for, but do not mind development mixing with production impressions for each license.

3. One player license per environment

Common Scenario Your company has a large number of monthly impressions for your production application/platform and from your team of engineers, and you want to separate these impressions to neatly organize them.


  • Do my license keys expire? No, your license keys do not expire.

  • How do I change or update a key in an application/platform? Change the key property within your Bitmovin Player configuration for web, or within the Android manifest / info.plist for iOS. This can be handled dynamically from your application

  • Is it possible to update a license key without changing an application’s code? Yes, the key could be provided via an API call designed by your team to your backend system and then passed dynamically to the Bitmovin Player.

  • Are there any scenarios when playback might be impacted because of key validation failures? Playback is only impacted if validation leads to a denied state. This is typically caused by a domain/app id/bundle id not being properly allow-listed from your Bitmovin Dashboard (see step #5 from the above tutorial)

  • What happens when playback impressions exceed the allotted impression count? For trial accounts, after the limit is reached playback will not work anymore. For production accounts, there is no hard limit and playback will always work. However, exceeding the number of impressions included in the contract for the given period leads to overage fees.

  • When does a license request occur and how often? License request happens once per page load (in the case of the web SDK). It's initiated once the first player instance is created.

Give us feedback