> For the complete documentation index, see [llms.txt](https://documentation.freshpaint.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.freshpaint.io/integrations/freshpaint-video-platform/video-player-templates.md).

# Video Player Templates

Templates control the player’s visual style, visible controls, and title overlay behavior. Videos assigned to a template use that template’s published version.

This page helps you:

* Create and edit reusable hosted video player styles
* Apply a template to one video or multiple videos
* Manage published template versions
* Understand when hosted embeds reflect styling updates

### Create a Template

1. Go to Video → Templates.
2. Click New template.
3. Enter a template name.
4. Optionally enter a description.
5. Configure the Template styling panel.
6. Review the Live Preview.
7. Click Create template.

Freshpaint creates version `v1` and publishes it automatically.

<figure><img src="/files/sJ3IS7PF5GkXVmfGJI7p" alt=""><figcaption></figcaption></figure>

### Customize Template Styling

Templates support these styling options:

* Play button style: `Filled`, `Outline`, or `Minimal`
* Play button shape: `Circle`, `Rounded`, or `Pill`
* Play button color: preset or custom color
* Show title on player: show or hide the video title overlay
* Title placement: `Top` or `Bottom`
* Control bar color: preset or custom color
* Progress bar color: preset or custom color
* Border radius: `0` to `32` pixels
* Visible controls: volume, captions, picture in picture, and fullscreen

### Save and Publish Changes

Template styling uses published versions.

When you save styling changes to an existing template, Freshpaint creates and publishes the next version automatically. All videos assigned to that template use the newly published version.

Metadata-only edits, such as name or description changes, update the template without creating a new styling version.

{% hint style="warning" %}
Important: Hosted video embeds can take a few minutes to reflect newly published template styling.
{% endhint %}

### Manage Versions

Open a template and use the Versions section to manage saved styles.

* Load into editor loads an older version for editing without saving or publishing it.
* Publish this version makes an older version active for all videos assigned to the template.

Publishing a version affects every hosted video using that template.

### Apply a Template to One Video

1. Go to Videos.
2. Open a hosted video.
3. In the Preview card, click Apply template or Change template.
4. Select a template in the Apply player template modal.
5. Click Apply template.

{% hint style="warning" %}
Important: Per-video custom styling is not supported. Create a template, then apply it to one or more videos.
{% endhint %}

<figure><img src="/files/pao8w6FBswebs377k0eS" alt=""><figcaption></figcaption></figure>

### Apply a Template to Multiple Videos

1. Go to Videos.
2. Select videos with the checkboxes.
3. Click Apply template in the selection bar.
4. Choose a template.
5. Confirm the selection.

Freshpaint applies the template to the selected videos. Hosted embeds can take a few minutes to show the updated styling.

<figure><img src="/files/zddhFwq1T48g8bok4wTF" alt=""><figcaption></figcaption></figure>

## Best Practices

Use templates for shared brand styles, campaign styles, or page-specific player treatments.

Preview styling before saving because saving style changes publishes a new version for all assigned videos.

Allow a few minutes after publishing or bulk applying templates before checking hosted embeds.