Add a text overlay

Text overlays are useful to add information like a title, location, or the date and time in to layouts in your channel. You can add text to any layout using the custom layout editor. The following tables lists shortcut codes that you can enter and the resulting content that appears on screen.

Overlay text shortcut codes

Item Shortcut code Example
date format: yyyy-mm-dd %F 2019-01-26
date format: mm/dd/yy %D 01/26/19
year %G 2019
month (01) %m 01
month (Jan) %b Jan
month (January) %B January
day of the month %d 26
weekday (Thu) %a Thu
weekday (Thursday) %A Thursday
time %T 08:40:45
hour %k 08
minute %M 40
second %S 45
millisecond %#m 378
channel name %c Camera Feed 1

If you use a non-monospaced font, the size of the text overlay changes as the letters, numbers, and the length of words change. Use a monospaced font to maintain a consistent size for the text overlay (assuming the total number of characters in the text string doesn't change).

You can include certain international characters in text overlays. Pearl-2 supports common character sets for Western and Central European languages, Nordic languages, and Russian. For a complete list, see International character support.

Add a text overlay using the custom layout editor

  1. Login to the Admin panel as admin, see Connect to Admin panel.
  1. From the Channels menu, select the channel and click Layouts. The custom layout editor opens.
  2. Click Add new item and select Text. The new item is added to the layout editing area and to the top of the list of items. The Text settings also appear.

You can change the order in which items appear on the layout editing area by re-arranging the order the items appear in the list beneath Add new item. Items at the top of the list appear in front, and items lower down the list appear behind.

  1. In the Text field, type what you want to appear in the text overlay. Include Overlay text shortcut codes as needed. Press Tab or click outside the text field to refresh the preview in the custom layout editor.

For example, if you enter:

%A %B %d, %G. Live streaming channel Auto A.

The resulting text is displayed:


  1. Select the Font, Font size, and Text color. You can also change the default Line spacing in percentages. For a mono-spaced font, use Droid Sans Mono.
  2. Limitations: The maximum supported text size is 500 px. Padding values must not exceed the frame size. Do not enter negative padding values.

  1. Resize the overlay text box using the padding settings.
  2. The handles on the corner of the overlay text box are not click-and-drag and do not resize the text box. To resize the text box, use the padding fields to add space above, below, and on either side of the text.

  3. In the layout editing area, click and drag to move the overlay text box or enter values in the manual position value fields along the side and bottom of the layout area.

  1. Click Save.