Imgix APIsVideo APIText Overlays

Text Overlays

Imgix supports compositing text directly onto video frames using the txt-* parameter family — the same parameters used for text overlays in the Rendering API. All txt-* parameters that work on images also work on video in Iris.

Multiple text layers

Video text overlays support up to 10 simultaneous text layers. The bare parameter (e.g. txt=...) defines layer 0. Additional layers use the [N] index syntax where N is 19.

https://assets.imgix.net/video.mp4?fm=mp4
  &txt=Hello&txt-size=48&txt-y=100
  &txt[1]=World&txt-size[1]=32&txt-y[1]=160&txt-color[1]=FF0000

Parameters without an index apply to layer 0 by default.

Video-specific parameters

In addition to the shared txt-* parameters, the following parameters are specific to video and control when and how text layers appear:

ParameterWhat it does
video-txt-startWhen the text layer appears (seconds from start)
video-txt-endWhen the text layer disappears (seconds from start)
video-txt-transitionEntry animation for the text layer
txt-shad-blurGaussian blur radius for the text shadow or glow
Use case

Add an opening title to a travel or social video that fades in, holds on screen, then disappears.

Uses txt, txt-size, txt-color, txt-align, video-txt-start, video-txt-end, and video-txt-transition=fade to show a centered title for the first 4 seconds.
https://assets.imgix.net/Croatia.mp4?fm=mp4&txt=Croatia%20Adventure&txt-size=56&txt-color=FFFFFF&txt-align=center%2Cmiddle&video-txt-start=0&video-txt-end=4&video-txt-transition=fade