Tags are used to modify element properties.

Tags can modify the way projects are rendered, analyzed and exported.


Example scenarios:

Hebrew subtitles need to be rendered right-to-left. Add a "right to left" tag to the Hebrew track.

You need to export Digital Cinema subtitles, and each track needs to be exported using its own GUID. Add a GUID tag to each track.


If you are familiar with non-linear editors, you can imagine tags as effects that you apply to clips.



There are different kind of tags.



Modify element attributes. For example, language, title, forced.



Specify render properties. For example, screen size, color depth, font, colors, outline.

Advanced tags allow subpicture remapping, transitions, pixel effects, and more.



Allows to use tags from a preset.



Specify the kind of errors to report when subtitles are analyzed.



Modify how subtitles are exported. For example, target file formats, destination folder, image cropping.

Advanced tags can segment files, compress files, and more.



Tags are inherited hierarchically. If a tag changes a property in one element, the change will be passed to all child elements.


For example, a tag added to the project will effect the project itself, and tracks and clips in the project.


 ∟ Tracks

     ∟ Clips


A tag added to a track will affect the track itself, all its clips, and sub-tracks.


 ∟ Clips

 ∟ Tracks

     ∟ Clips



When you export subtitles using an exporter (or just preview subtitles in the monitor using an exporter) its tags will also affect the rendering.


 ∟ Exporter

     ∟ Track

         ∟ Clips

             ∟ (Exporter)


For technical reasons, the exporter will be inserted in the hierarchy two times, and therefore, it will be evaluated two times.

However, the second time, only some of its tags will be evaluated (called second pass tags).


The first evaluation allows the exporter to override properties in the project. The second evaluation allows to override properties in the entire rendering pipe.


For example, if an exporter specifies a font name, a Japanese track can override the font name and set a Japanese font instead.

Project (Default font)

 ∟ Exporter (Arial)

     ∟ Track JAP (Arial Unicode)

         ∟ Clips