Title: WebVTT
Author: bobbywalters
Published: <strong>August 19, 2015</strong>
Last modified: December 3, 2017

---

Search plugins

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://s.w.org/plugins/geopattern-icon/webvtt.svg)

# WebVTT

 By [bobbywalters](https://profiles.wordpress.org/bobbywalters/)

[Download](https://downloads.wordpress.org/plugin/webvtt.zip)

 * [Details](https://pcd.wordpress.org/plugins/webvtt/#description)
 * [Reviews](https://pcd.wordpress.org/plugins/webvtt/#reviews)
 *  [Installation](https://pcd.wordpress.org/plugins/webvtt/#installation)
 * [Development](https://pcd.wordpress.org/plugins/webvtt/#developers)

 [Support](https://wordpress.org/support/plugin/webvtt/)

## Description

Creates any number of HTML5 elements for uploaded WebVTT files for videos displayed
using the `[playlist]` and `[video]` shortcodes.

The uploaded WebVTT file names must follow this convention to be recognized:
 + 
+ + + + ‘.vtt’

With each value described as:

 * `<video file name>` The base file name of the video file (without it’s extension).
 * `<separator>` A normalized single character separator typically a dash `-` to
   match the WordPress name normalization pattern.
 * `<WebVTT track kind>` The kind of text track. The kind is defined by the HTML5
   specification and may be one of:
    - captions
    - chapters
    - descriptions
    - metadata
    - subtitles
 * `<separator>` (defined above)
 * `<language code>` The language of the track text data. This is a lower case 2
   character code that represents the language only part of a full BCP 47 language
   tag. Here’s a listing of available [language codes](http://www.w3schools.com/tags/ref_language_codes.asp)
   for reference.
 * `'.vtt'` The recognized standard file extension for WebVTT files.

As an example, a video file named `'my-video.mp4'` would be able to leverage uploaded
track files named:

 * `'my-video-chapters-en.vtt'` to add English chapters
 * `'my-video-subtitles-en.vtt'` to add English subtitles
 * `'my-video-subtitles-es.vtt'` to add Spanish subtitles

## Screenshots

 * [[
 * Upload video and associated VTT files following the naming convention.
 * [[
 * Video being displayed using the `[video]` shortcode with the VTT tracks available.
 * [[
 * Video and VTT attachments display reference links on media library and edit pages.
 * [[
 * Localization support on all screens.

## Installation

 1. Upload entire **webvtt** directory to `/wp-content/plugins/` directory
 2. Activate the plugin through the ‘Plugins’ menu in WordPress
 3. Upload new or see existing VTT files with the correct naming convention become 
    available to HTML5 videos displayed using the `[video]` shortcode

## FAQ

  Installation Instructions

 1. Upload entire **webvtt** directory to `/wp-content/plugins/` directory
 2. Activate the plugin through the ‘Plugins’ menu in WordPress
 3. Upload new or see existing VTT files with the correct naming convention become 
    available to HTML5 videos displayed using the `[video]` shortcode

  Why aren’t my VTT files available with my video?

The uploaded WebVTT file names must follow this convention to be recognized:
 + 
+ + + + ‘.vtt’

This avoids:

 * the need for a settings page
 * extra meta data fields and trying to keep these in sync
 * having to re-upload a video when a VTT file is changed or updated

Please see the Description section for a full explanation of the VTT file name format.

## Reviews

![](https://secure.gravatar.com/avatar/96d07783c5d602819907ca7575dd277c6497fd721fd4cc4197a4471aa2e44471?
s=60&d=retro&r=g)

### 󠀁[Works like suppose to](https://wordpress.org/support/topic/works-like-suppose-to/)󠁿

 [Leo Caseiro](https://profiles.wordpress.org/leocaseiro/) September 3, 2016 1 reply

Don’t need setup! It’s perfect! Exactly what I need

 [ Read all 1 review ](https://wordpress.org/support/plugin/webvtt/reviews/)

## Contributors & Developers

“WebVTT” is open source software. The following people have contributed to this 
plugin.

Contributors

 *   [ bobbywalters ](https://profiles.wordpress.org/bobbywalters/)

[Translate “WebVTT” into your language.](https://translate.wordpress.org/projects/wp-plugins/webvtt)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/webvtt/), check out
the [SVN repository](https://plugins.svn.wordpress.org/webvtt/), or subscribe to
the [development log](https://plugins.trac.wordpress.org/log/webvtt/) by [RSS](https://plugins.trac.wordpress.org/log/webvtt/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.3.2

2016-08-28

 * FIX: Removed unneeded `empty()` calls.

#### 1.3.1

2016-08-28

 * FIX: Updated usage of `empty()` to be compatible with PHP versions prior to 5.5.

#### 1.3.0

2016-08-27

 * NEW: VTTs will now show up when using the `[playlist]` shortcode.
 * FIX: Sanitize video name when querying for VTTs.
 * FIX: Retrieve vide name from URL with query parameters.

Props @leocaseiro.

#### 1.2.0

2015-08-30

 * NEW: Added POT and first translation (Spanish).
 * NEW: Added screenshots of media library and localization support.
 * FIX: Better attachment metadata localization handling in media library view.

#### 1.1.0

2015-08-29

 * NEW: Links between video and VTTs are shown in the media library and on edit 
   pages.
 * NEW: Improved VTT query performance and results can now be cached.
 * NEW: Filter by `Video tracks` in media library to show only VTT attachments.
 * NEW: Using [classes plugin boilerplate](https://github.com/DevinVinson/WordPress-Plugin-Boilerplate).
 * FIX: Cleaned up [PHPCS WordPress standard](https://github.com/WordPress-Coding-Standards/WordPress-Coding-Standards)
   sniffs.

#### 1.0.1

2015-08-19

 * NEW: Added Screen shots and filled in more readme sections.
 * FIX: Corrected `.vtt` file names in examples.

#### 1.0.0

Initial release.

## Meta

 *  Version **1.3.2**
 *  Last updated **8 years ago**
 *  Active installations **10+**
 *  WordPress version ** 3.6.0 or higher **
 *  Tested up to **4.9.29**
 *  Language
 * [English (US)](https://wordpress.org/plugins/webvtt/)
 * Tags
 * [HTML5](https://pcd.wordpress.org/plugins/tags/html5/)[track](https://pcd.wordpress.org/plugins/tags/track/)
   [video](https://pcd.wordpress.org/plugins/tags/video/)
 *  [Advanced View](https://pcd.wordpress.org/plugins/webvtt/advanced/)

## Ratings

 5 out of 5 stars.

 *  [  1 5-star review     ](https://wordpress.org/support/plugin/webvtt/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/webvtt/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/webvtt/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/webvtt/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/webvtt/reviews/?filter=1)

[Add my review](https://wordpress.org/support/plugin/webvtt/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/webvtt/reviews/)

## Contributors

 *   [ bobbywalters ](https://profiles.wordpress.org/bobbywalters/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/webvtt/)