This page has been updated for JW Player 8. Click here to go to the JW7 CSS Skinning Reference.

CSS Skinning Reference

This article acts as a reference for styling all interface components of JW Player 8. This skinning model uses CSS, and all controls are overlaid on top of the player with HTML. JW8 uses inline SVGs for all icons.

When styling these elements, there are a few conventions to keep in mind. All internal classes are prefixed with jw- in order to protect the player from external stylesheets. The original DOM element that we initialize is called the Main Div.

A JW Player skin CSS file contains classes that are grouped into functional elements. This reference provides an elaborate overview the classes used. For additional information, check out a reference css file.

Main Div

The main div will be given a class jwplayer. It is strongly advised to not add any additional inline styling on this div besides what is included in your skin css file.

Player States

The state of the player is reflected in the DOM by a class on the main div. It will always contain one of the following:

CSS Class Definition
.jw-state-playing While content is playing
.jw-state-paused While content is paused
.jw-state-buffering While content is buffering
.jw-state-idle Before pressing play
.jw-state-complete After playlist completes


Sometimes the player needs to signify certain modes of the playback. These flags will be present on the main div and can be:

CSS Class Definition
.jw-flag-fullscreen When the player is in fullscreen
.jw-flag-live When the player is playing back live video
.jw-flag-user-inactive Added after a few minutes of inactivity
.jw-flag-controlbar-only Player is less than 30 pixels tall
.jw-flag-media-audio Content being played is an audio file
.jw-flag-dragging Mouse down with cursor over control bar
.jw-flag-aspect-mode Enable a padding to create an aspect ratio


CSS Class Definition
.jw-background-color This is a class that will add a set of style to all interface elements without having to change it for each individual class.

We advise only using .jw-background-color for color and not other CSS properties. The player will add this class to the following elements:

  • .jw-display-icon-container
  • .jw-controlbar
CSS Class Definition
.jw-button-color This is a class that player will add to specific elements when color is overridden from within the player configuration setup. You can also use this to easily change all button colors in your skin. The player will add this class all icons.
.jw-button-color:hover This will adjust the color of all buttons when they are hovered on.

Poster Images

These define how the poster image will be stretched to fill the space given. Internally this state is used to stretch the player using JS.

  • .jw-stretch-none
  • .jw-stretch-uniform
  • .jw-stretch-fill
  • .jw-stretch-exactfit


All player controls are within the .jw-controls class. When JW Player is set to controls: false, this entire class has a visibility of hidden. To not include a specific item in your skin, you will need to override the style with a visibility or display of none.

Group Definition
Display The set of icons in the center of the player
Controlbar The playback controls for the player
Menus Extensions of the controlbar that display additional information
Logo A logo displayed for branding purposes
Preview The video's poster image


The display component contains the main element container for the (re)play, buffer and error icons in the middle of the screen. To add styles to these containers based on states you will need to add the state classes in your stylesheet.

CSS Class Definition
.jw-display-icon-container Used to style the container in which the display icons are.
.jw-icon-display Used to style icons that appear in the display container. The icon that is rendered depends on the state the player is in.


The controlbar component contains all elements for the video controls at the bottom of the player. All elements are contained within the .jw-controlbar parent class and broken out into two groups, .jw-slider-time and .jw-button-container.

CSS Class Definition
.jw-slider-time Used to position the player timeslider above playback controls
.jw-button-container Used to group and position specific playback controls

Slider Time

The center group contains the elements that make up the player's timeslider.

CSS Class Definition
.jw-slider-horizontal .jw-slider-container The containers that hold the timeslider elements
.jw-rail Sets the style for the base layer of the slider
.jw-buffer Sets the style for the how much of video has been buffered, which is layered on top of .jw-rail
.jw-progress Sets the style for the elapsed video, which is layered on top of .jw-buffer
.jw-knob This marks the tip of the progress rail, used to indicate where playback is currently
.jw-slider-horizontal .jw-cue This class is used for timeslider cuepoints, like chapters and ad breaks

Button Container

The button container contains playback controls, elapsed and duration time, and the settings menu:

CSS Class Definition
.jw-icon-playback Container that holds the play/pause icons. This icon will toggle depending on the state of the player
.jw-icon-rewind Container that holds the "rewind" icon
.jw-icon-next Playback control to advance to the next playlist item.
.jw-icon-volume Container that holds the volume icon. The player will automatically add an overlay to the hover state of this div that contains the slider volume.
.jw-icon-volume .jw-off When the player is muted the .jw-off class gets added to toggle the volume off icon.
.jw-icon-live Container for live and dvr icons. This icon will toggle depending on the state of the player.
.jw-text-elapsed Container for the elapsed video time.
.jw-text-duration Container for the total duration of the media file.
.jw-settings-sharing Container for the sharing icon. This will only show when sharing is enabled.
.jw-playlist-btn Container for playlist icon. This icon represents the player using a manual playlist for related content.
.jw-related-btn Container for discover icon. This icon represents the player using recommendations for related content based on the mediaID.
.jw-icon-cc Container for the closed-caption CC icon. This icon will toggle to an on and off state depending on whether closed captions are enabled or not.
.jw-icon-cast This container will display the Chromecast or Airplay icon depending on which feature is available.
.jw-icon-settings Container for the settings menu icon.
.jw-icon-fullscreen Container for enter and exit fullscreen icons. This icon will toggle between fullscreen on and off depending on the state of the player.

Break Points

Breakpoint classes are added to the player element based on the width of the player, not the device or browser. Because JW Player instances are embedded via an iframe, the usual @media query will not work for defining CSS declarations to make elements responsive. Breakpoints are global classes that can be used to make responsive CSS declarations for any customizable player element.

Break Point Width Intervals (px)
.jw-breakpoint-0 Player width: 0-319
.jw-breakpoint-1 Player width: 320-419
.jw-breakpoint-2 Player width: 420-539
.jw-breakpoint-3 Player width: 540-639
.jw-breakpoint-4 Player width: 640-799
.jw-breakpoint-5 Player width: 800-959
.jw-breakpoint-6 Player width: 960-1279
.jw-breakpoint-7 Player width: 1280+


Make font size smaller only when player width is under 420px wide:

.jw-breakpoint-0 .jw-related-item-description {
font-size: 11px;

For medium-sized player widths, make the font size bigger:

.jw-breakpoint-3 .jw-related-item-description,
.jw-breakpoint-4 .jw-related-item-description {
  font-size: 16px;

Settings Menu and Submenus

CSS Class Definition
.jw-settings-menu This container creates a menu based on what playback features are enabled for the player.
.jw-settings-submenu A submenu is created to list available options for each menu feature.
.jw-settings-content-item This container is populated with the options related to each submenu.

Tooltips and Overlays

JW Player will automatically populate overlay divs on mouseover/touch of certain interface elements. These include the timeslider thumbnail preview, volume slider and on-hover tooltips for controlbar icons.

CSS Class Definition
.jw-overlay All overlays are wrapped in this class. It is not advised to modify this class but rather the containers within this class. This class when appended to the parent controlbar class will position the overlays.
.jw-tooltip On-hover tooltips containning labels for controlbar icons.

Title and Preview Image

The title and description configuration options are displayed in their own classes overlaid on the player.

CSS Class Definition
.jw-title This is the wrapper class the text overlays.
.jw-title-primary This class is populated with content from the title configuration option from the player setup.
.jw-title-secondary This class is populated with content from the description configuration option in the player setup per-playlist item.
.jw-preview This class styles the preview image from the image configuration option in the player setup per-playlist item.

Discovery Overlay

The discovery overlay displays recommended content related to the current media file. The overlay uses breakpoints to select the proper format and amount of items to display.


CSS Class Definition
.jw-plugin-related Customize the background color of the related overlay
.jw-related-item-content Customize the background and border color of related items
.jw-related-item-content:hover Customize the background and border color of related items when hovering
.jw-related-item-duration Customize the next-up related item duration text
.jw-related-item-play Customize the next-up related item play button
.jw-related-item-title strong Customize the next-up related item "Next Up" text
.jw-related-item-title span Customize related item title text
.jw-related-item-title .jw-item-index-text em Customize related item title (for playlists) text
.jw-related-item-description Customize related item description text (Auto-advance only)
.jw-related-autoplay-frame Customize related item autoplay progress (Auto-advance only)
.jw-related-autoplay-frame-progress Customize related item autoplay progress (Auto-advance only)
.jw-related-item-content:hover .jw-related-autoplay-frame-progress Customize elements in hover state (falls under .jw-related-item-content:hover)


CSS Class Definition
.jw-plugin-related Parent container for related overlay plugin that covers the player viewport when visible.
.jw-related-close Related overlay close icon button
.jw-related-item-content Item content area
.jw-related-item-poster Poster image container (poster image is set via inline style background image on this element)
.jw-related-item-duration Item duration text
.jw-related-item-play Next-up item play button container
.jw-related-item-play .jw-display-icon Next-up item play button icon
.jw-related-item-title-content Title text
.jw-related-item-description-content Description text
.jw-related-autoplay-frame Item autoplay border
.jw-related-autoplay-frame-progress Item autoplay progress border

Next Up Card

The next up card displays prior to a video's completion, showing information about the following media item.


CSS Class Definition
.jw-nextup-header Customize the top bar with "Next Up" label
.jw-nextup-body Customize the thumbnail/title group container
.jw-nextup-thumbnail Customize the next up item thumbnail
.jw-nextup-title Customize the next up item title
.jw-nextup-close Customize the close button
.jw-nextup-close:hover Customize the close button hover state


CSS Class Definition Type
.jw-nextup-container Parent container for next up (hidden by default) that positions the next up display in the player. default
.jw-nextup-container-visible Add-on class for next up parent container that transitions the next up display to visible state. state
.jw-nextup Second container element for next up with position: relative CSS property set to enable absolute positioning of the close button. default
.jw-nextup-header Top bar element for next up that contains the "Next Up" label text. default
.jw-nextup-body Grouping container element for the next up thumbnail and title. default
.jw-nextup-thumbnail Thumbnail element for next up display (hidden by default). Element uses inline style background-image: url(thumbnail.jpg); in addition to background-size: cover to accommodate displaying any thumbnail size in an elegant way. default
.jw-nextup-thumbnail-visible Modifier class that makes the next up thumbnail element visible (set when next up item has a thumbnail). state
.jw-nextup-title Title text element for next up display. default
.jw-nextup-close Close button for next up (hidden by default) which hides the display when clicked. default
.jw-nextup-sticky .jw-nextup-close State to show close button for next up display (shown when nearing end of current video). state