Customizing the ad overlay text

This guide explains how to customize the overlay texts during an adbreak, if any. You may ask this question if you want to change the aspect or the content of the overlay displaying the countdown to content on top of the ads.

This is done in two steps: the first is to customize the text, if you so desire. For this we will be leveraging the language localization mechanism. You can find further information on this regard at UIConfiguration.language.

The second step is to change the aspect of such text. This can be done via CSS. 

Table of Contents


Web SDK Android SDK iOS SDK tvOS SDK Android TV SDK Chromecast SDK
Yes Yes Yes Yes No N/A

Changing the text

In this paragraph, we will explain how to modify the text. We will take the countdown to the content text as an example (another ad overlay text is the "Skip ad" text, if any). When considering a new text to replace the original one, it is important to take into consideration its length (which should be determined accordingly to the available space) and how it is composed.

The current example is composed of 3 parts: one text ("The content will play in"), a dynamic countdown and another text ("seconds"). For this reason, when changing the text, both text parts need addressing.

Code examples

ui: {
        // your other ui configuration
        language: 'en',
        languages: { 'en':
                        "The content will play in": "Here your customised text",
                           "seconds": "Here your customised text"
                        // any other translation or text change
Android SDK
//Example of THEOplayerConfig with language localization enabled
THEOplayerConfig playerConfig = new THEOplayerConfig.Builder()
    .ui(new UIConfiguration.Builder().language("nl").build())
//to be added

Changing the aspect

If you are interested in changing the aspect of the overlay or its content, you may do so applying the desired CSS properties to the concerned elements.

Code examples

/* This modifies the countdown div */
.theo-ad-remaining-container {
/* your styles here */

/* This modifies the skip ads div */
.theoplayer-ad-skip {
/* your styles here */

/* this can also be further differentiated in 2 cases:*/

/* the countdown */
.theoplayer-ad-skip.theoplayer-ad-skip-countdown {
/* your styles here */

/* the button */
.theoplayer-ad-skip.theoplayer-ad-skip-button {
/* your styles here */
Android SDK

The Web SDK code should be included in your Android (TV) project. The article at How to add CSS or JavaScript files to an Android/iOS project explains how you can add CSS and JavaScript files to your project. 


TheWeb SDKcode should be included in your iOS project. The article at How to add CSS or JavaScript files to an Android/iOS project explains how you can add CSS and JavaScript files to your project. 


  • This will have no effect when using the google IMA integration: in this case, google IMA manages its own language localisation. Also, no countdown to the content is currently displayed when using the google IMA integration, so this is to me remarked only for the text about skipping the ads, if any.


Make sure to follow us on GitHub!
Copyright © 2022. All Rights Reserved.
New York