Skip to content
mister-ben edited this page Jan 14, 2016 · 11 revisions

Having problems with Video.js? Did you double check the getting started guide and other documentation? If you still can't get things working, follow the matrix below before opening an issue.

Is your problem specific to a plugin that uses Video.js?

If you can't reproduce the issue in Video.js outside of that plugin, please open a ticket with that project.

Having problems installing or using Video.js on your website?

The issue tracker is really for confirmed bugs, so if you have a question about how to use Video.js or need help getting started, you should post your question to Stack Overflow.

Stack Overflow is a great resource, but to get the most out of it it is important to follow their guidelines. The community moderation is sometimes harsh, and "bad" questions tend to be downvoted and closed before you will get an answer.

  • Avoid duplicates: Search first to see if the question has been answered, and also see the questions with most votes. If you find a question that appears similar but is not the same, that's good information too — link to that in you question and explain the distinction.
  • Write "good" questions: Follow Stack Overflow's guidelines on how to ask good questions. Stack Overflow users can quick to vote down questions they consider "low quality", which makes them less likely to be seen by others who could help.
  • Stick to Stack Overflow's Q&A format: If you ask a new question as an answer or comment on another question, it probably will not be noticed.
  • Tag the question: Use the video.js tag and other tags that are relevant to the question. Avoid adding only tenuously relative tags, as this could attract downvotes.
  • Be clear that you're talking about video.js: This helps ensure that the answers you get are relevant and not something only applicable to a plain HTML5 video element. This is especially important if you add high-traffic tags such as jquery or javascript.
  • Be specific: Include the version of video.js and any plugins you are using.
  • Include your code and what you've tried: Provide a minimal, complete and verifiable example so others can reproduce your problem. Stack Overflow likes you to put the code directly in the question, otherwise sites such as jsbin are useful to host a simplified test case.
  • Help others: Answer questions and use the voting system. Up-voting and accepting good answers helps others find solutions that work. Down-voting bad or misleading answers helps others avoid them.

Have an awesome feature you added (or idea for one)?

That's awesome! The goal is to keep the Video.js core as light-weight as possible, so at this point, most additional features should be a plugin. If you do create a plugin, let us know so we can add it to the list.

Find something wrong with the website?

The website has its own repository, so please let us know there.

No seriously, it's a bug.

If none of the above applies to you and you believe you've found a bug in Video.js, please create a new issue for it. One of the most important things you can give us to help solve the problem is a reduced test case, so before doing anything else, try your best to create one. We have a starter template on JSBin that you can use.

To make things easier for the people that will look into your issue, please use the following format.

What did you do? (steps to reproduce)

Explain in detail the steps that led to finding the bug. Can you reproduce it consistently? Which browser are you using? Is there a reduced test case? Code samples are really, really helpful (especially nicely formatted ones).

<video id="my_video_1" class="video-js vjs-default-skin" controls data-setup="{}">
  <source src="my_video.mp4" type='video/mp4'>
</video>

<script type="text/javascript">
  function myScript() {
    console.log('Y U NO WORK!!!');
  }
</script>

What happened? (actual results)

The more detail, the better. Include anything you can, including screenshots, live examples with the bug, or any error messages (don't forget about the JavaScript console).

What should have happened? (expected results)

What did you think would happen? Include specific documentation examples that support your expectation (this helps make sure the docs are right).

Additional Information

Please also answer the following questions. They may not seem relevant to your specific issue, but they will often speed up the process either way.

  • What version of Video.js and any plugins used?
  • What browsers and platforms does this occur/not occur on?
  • Is there a link to an example online?
  • Can a reduced test case be created? (e.g. a jsbin)

To make things a little easier, just copy and paste this into an issue and start editing:

**What did you do? (steps to reproduce)**

Detailed description of what you did, along with a link to your reduced test case.

Replace the code sample below with your own.

 ```html
 <video id="my_video_1" class="video-js vjs-default-skin" controls data-setup="{}">
   <source src="my_video.mp4" type='video/mp4'>
 </video>
function myScript() {
  console.log('Y U NO WORK!!!');
}

What happened? (actual results)

What should have happened? (expected results)

Video.js version (e.g. v4.3.0)

Video.js plugins used (e.g. videojs-youtube)

Browsers + platforms where this is happening (e.g. Windows XP IE8)

Browsers + platforms where this is NOT happening (e.g. Mac Chrome 30)

Reduced test case or online example (link)

[Create a new issue](https://github.com/videojs/video.js/issues/new)