Vertical Video Customization Reference
Discover the available vertical video UI customizations
You can customize the appearance and interface text of the vertical video discovery experience to match your website's design. The Carousel and Full screen (inclusive of Single player) modes can be styled independently. Any interface text overrides apply to all modes.
Customize the vertical video feature
Follow these steps to customize each vertical video component:
- Update your stylesheet with your desired CSS and localization customizations through one of these approaches:
- Existing Stylesheet: Add the necessary overrides to your current website stylesheet.
- New Stylesheet: Build a new stylesheet with the required customizations.
- Add a reference to your chosen stylesheet in the
<link>element within the<head>section of your HTML pages.<!DOCTYPE html> <html> <head> ... <link rel="stylesheet" href="custom_style.css"> </head> <body>...</body> </html>This will enable you to adjust elements such as button colors, title fonts, and backgrounds, ensuring the player aligns with your site’s style.
CSS Reference
The following sections explain how to customize UI elements of the vertical video components.
When customizing these components, be mindful of the following:
- Only modify the vertical video element properties listed.
- Avoid adding other styles to the provided CSS selectors.
- Use
!importantsparingly, as overuse can lead to unintended style conflicts.
Carousel
| Setting | Description & Code |
|---|---|
| Carousel Background Color | Sets the background color of the carousel |
| Description Color | Sets the color of the description text |
| Navigation Button Background Color & Color | Sets the background color and color of the navigation button |
| Navigation Button Icons | Customizes the existing navigation icons OR defines custom navigation iconsSets the color of the existing button iconsOR Sets custom button icons and their colorsTo change navigation icons, include a reference to the icon font in the For example, follow these steps to use the free Font Awesome 6 library:
|
| Play Icon Color | Sets the color of the play icon |
| Time Indicator Color | Sets the color of the time indicator |
| Title Color | Sets the color of the title text |
| Video Border Radius | Sets the radius of the video border |
Captions
.jw-vertical-video.jw-vertical-video-fullscreen .jw-vv-captions {
color: rgba(255, 0, 0, 1);
font-size: 20px;
font-family: Arial, sans-serif;
text-shadow: 0 2px 1px #000;
background-color: rgba(0, 0, 255, 0.5);
}
| Setting | Description |
|---|---|
| color | Color of the caption text
To set the opacity, use RGBA format. Otherwise, use HEX format. |
| font-size | Size of the caption text |
| font-family | Typeface used for the caption text |
| text-shadow | Visual effect applied to the edges of the text
Possible values:
|
| background-color | Color behind the text of the caption
To set the opacity, use RGBA format. Otherwise, use HEX format. |
Fullscreen
Button layout position and button stack orientation cannot be customized through the vertical video CSS. These customizations must be made on the UX tab.
| Setting | Description & Code |
|---|---|
| Close Button Color | Sets the color of the close button |
| CTA Button: Hide Default SVG Icon | Hides the default SVG icon of the click-to-action (CTA) button
|
| CTA Button: Insert SVG Icon | Inserts an SVG icon via pseudo-element for the click-to-action (CTA) buttonThe following example injects an arrow.
|
| CTA Button: Override Styles | Override the styles of the click-to-action (CTA) button
|
| Description Color | Sets the color of the description text |
| Mute Button Color | Sets the color of the mute button |
| Navigation Button Background Color | Sets the background color of the navigation button |
| Navigation Button Background Color Disabled State | Sets the background color of the navigation button (disabled state) |
| Button Layout Position | Customizations to the button layout position can be made on the UX tab. |
| Button Stack Orientation | Customizations to the button stack orientation can be made on the UX tab. |
| Navigation Button Icons | Customizes the existing navigation icons OR defines custom navigation iconsSets the color of the existing button iconsOR Sets custom button icons and their colorsTo change navigation icons, include a reference to the icon font in the For example, follow these steps to use the free Font Awesome 6 library:
|
| Play/Pause Icon Color | Sets the color of the play/pause icon |
| Timer Color | Sets the color of the timer |
| Title Color | Sets the color of the title text |
Localization Reference
To localize individual labels, declare the associated CSS custom properties in your stylesheet. Each label is resolved independently, so labels without an override continue to use the selected interface language.
The vertical video discovery experience automatically selects a supported interface language by checking the page’s <html lang> attribute first and then the viewer’s browser language navigator.language. If neither value identifies a supported language, the interface defaults to English.
Define the custom properties on
:rootbefore the placement initializes. Override values are literal text and are displayed regardless of the automatically selected language. Changes made after initialization do not update rendered labels.
:root {
--jw-vv-play-sound: "Ton einschalten";
--jw-vv-share: "Teilen";
--jw-vv-next-video: "Nächstes Video";
}
| CSS custom property | Interface element | Default text |
|---|---|---|
--jw-vv-advertisement |
Ad label in the new UI | Advertisement |
--jw-vv-cta-more |
Default CTA button label | More |
--jw-vv-link-copied |
Share confirmation tooltip | Link copied |
--jw-vv-next-video |
Up-next card displayed during an ad | Next Video |
--jw-vv-now-playing |
Related video card status | Now playing |
--jw-vv-play-now |
Related video card status | Play now |
--jw-vv-play-sound |
Interactive mute button | Play sound |
--jw-vv-related-videos |
Related videos heading | Related Videos |
--jw-vv-resume-after-ad |
Related video card status | Resume after ad |
--jw-vv-share |
Share button aria-label |
Share |
--jw-vv-sponsored |
Ad label in the old UI | Sponsored |
--jw-vv-swipe-for-more |
Mobile swipe hint | Swipe up for more |
Updated 18 days ago
