9.4. Adding Videos to a Course

After automated processing of an uploaded video file begins and its status on the Video Uploads page is “Ready”, you can include it in your course. To do so, you copy the unique ID that is assigned to an uploaded video and then add it to a video component. A video file, Adding a Video ID, is also available to show you how to complete this process.

This section also describes how you add a transcript and associate it with the video file in a video component.

9.4.1. Copy the Video ID

  1. Open the course in Studio.

  2. Select Content, then Video Uploads.

  3. In the Previous Uploads list, locate the video that you want to include in the course.

  4. Select the value in the Video ID column for the video. The video ID is assigned when you upload a video.

  5. Right-click the value, and then select Copy. Be sure to select and copy the entire video ID value. You will paste this value into the Video ID field for a video component. For more information, see Add the Video ID to a Video Component.


    The Previous Uploads list has a video ID for every uploaded video file. However, for a video to play successfully, the status for the file must be “Ready” on the Video Uploads page.

You can also download a report of all uploaded videos on the Video Uploads page: select Download available encodings (.csv). The report includes the video ID for every uploaded file.

9.4.2. Add the Video ID to a Video Component

This section describes the procedure that course teams follow to add an uploaded video file to a video component in an edx.org course. You follow this procedure in place of the Step 4. Create a Video Component section in this guide. This section assumes that you are familiar with the procedures described in the Developing Your Course section.

You complete these steps in Studio. For convenience, download the report of uploaded videos and open it on your desktop before you begin. Alternatively, open a second browser window so that the video IDs on the Video Uploads page appear in one window while you work with video components in the other.

  1. On the Content menu, select Outline. The Course Outline page opens.

  2. Add or edit a video component.

    To add a video component, select or add a unit, and then select Video under Add New Component. Then, in the new component, select Edit.

    To edit an existing video component, locate the video component in a unit, and then select Edit.

    The Editing: Video dialog box opens to the Basic tab.

  3. In the Component Display Name field, enter the name that you want learners to see for this video.

  4. In the Video ID field, paste the video ID for the video file. For more information, see Copy the Video ID.


    When you add a valid video ID in this field, you associate your video component with files on YouTube and AWS that are optimized for viewing with different devices and bandwidths. You do not need to add values to the Default Video URL, Video File URLs, or YouTube ID fields. The URLs that are associated with the video ID override any existing values in those fields.

  5. In the Editing: Video dialog box, select the Advanced tab.


    The Component Display Name field and the Video ID field are present on both the Basic tab and the Advanced tab. You can enter values for these fields on either tab.

  6. Set Video Download Allowed to True or False to define whether learners can download this video.

  7. Select Save. The referenced video appears in the video component.


    For the video to appear, a destination URL must be available for at least one of the formats and host sites that are the result of the edX video process.

To complete video component setup, you add a transcript file for the video.

9.4.3. Add a Transcript

Transcripts are required for your videos. Transcripts are required for deaf or hard of hearing learners to understand audio content, and helpful for learners who speak other languages.

Timed transcripts in the SubRip Text (.srt) format are recommended. A transcript in the .srt format appears next to its associated video and automatically scrolls as the video plays. A learner can select a word in the transcript to jump to the point in the video where that word is spoken.

This section briefly describes the procedures that course teams follow to add transcripts to their videos. For more information, see the Step 2. Create or Obtain a Video Transcript section in this guide. Create or Obtain a Transcript

To create or obtain a transcript in .srt format, you can work with a company that provides captioning services.

To ensure quality and accuracy of transcripts, edX works with 3Play Media. To request a 3Play Media account at edX’s discounted rate, contact 3Play at http://www.3playmedia.com/edx/. Associate a Transcript with a Video

Before you can associate a transcript with a video, the encoding and hosting process must be complete for the video file, and its status must be Ready on the Video Uploads page. You make the association between a video file and a transcript file in Studio, in the video component.

  • If your captioning service provider delivers .srt files to you, you can upload the .srt file from your computer.
  • If your captioning service provider adds subtitles or closed captions to your videos on YouTube, you can import those subtitles or captions from YouTube.

Studio saves files from either source in the SubRip (.srt) format. Studio also saves the files in text (.txt) format automatically.

To associate a transcript with a video, follow these steps.


This procedure assumes that you have already created the video component and followed the procedures to add the video ID to it. In addition, you must have the .srt file, or the subtitles or captions must be available on YouTube, before you complete these steps.

  1. On the Course Outline page in edX Studio, locate the unit that contains the video component, and then select the unit name.
  2. Locate the video component window and select Edit.
  3. Next, either you upload an .srt file or you import YouTube subtitles or captions.
    • To upload an .srt file from your computer: For the Default Timed Transcript select Upload New Transcript, and then select the .srt file from your computer.
    • To import YouTube subtitles or captions: For the Default Timed Transcript select Import from YouTube.
  4. Select Save.

To test the transcript with the video, select the Show transcript (”) icon in the video player’s control bar. The transcript file scrolls while the video file plays. You can also test the transcript by selecting the CC icon.


In some cases, two sets of captions can appear when you select CC. This situation can occur if YouTube is the host service for the video and your YouTube account settings for playback are set to always show captions. As a result, YouTube and your course might both provide captions for the video. To correct this problem, select CC again or change your YouTube account setting. Enable Transcript Downloads

You can allow learners to download transcript files so that they can read them offline. You can enable downloads for transcripts that you upload yourself or that you import from YouTube.

To enable transcript downloads, follow these steps.

  1. On the Course Outline page in edX Studio, locate the unit that contains the video component, and then select the unit name.
  2. Locate the video component window and select Edit.
  3. Select Advanced.
  4. Set Download Transcript Allowed to True.
  5. Select Save. The referenced files (.srt) and (.txt) are now available to download.

To test transcript downloads for the video, select Download transcript in the video player’s control bar. You can choose either the SubRip (.srt) format or text (.txt) format to download.