How can we help?

My Cases

Configuring Blackboard to Allow Students to Embed from their Echo360 Library
Last Updated: May 13, 2019 02:30PM EDT

This article applies to:  Echo360 Admins

If you have installed and configured the building block, the Echo360 Video Library option under Mashups will be visible for both Instructors and Students to embed videos from their Echo360 library into Blackboard content windows.  However, Blackboard's default policy configuration strips many URLs from embeds done by students. To change this, a Blackboard Administrator must add entries for Echo360 into the default policy configuration file.  

You actually have two options with respect to students embedding videos from Echo360:

  • If you want Blackboard to not strip the Echo360 URL from student embeds (making the embed non-functional) you must add the Echo360 URL to the default policy XML file for iframes (also referred to as "white-listing" the Echo360 site).
  • If you want student video submissions for Assignments to be locked down in Echo360 (student cannot edit or delete the video once submitted), you must also add the echo-library into the white list. 

Student assignment lock-down is provided with version 1.0.8 and later of the Echo360 Building Block. See Adding an Echo360 Video Library option in Blackboard Mashups if you need to update to a newer version. If you have the current Building Block installed, the below procedure for white-listing Echo360 and the echo-library should be sufficient to allow students to embed and to lockdown assignment submissions.

REMEMBER that in order for students to embed videos, the Student Library must be enabled, and the Student toggle for Embeddable and Public Links must also be enabled for the institution.

The following procedure must be performed by a Blackboard Administrator. As with all Blackboard Instructions provided in the Echo360 documentation, the procedure below is intended as a guide and may differ depending on the version you are using. If you need further assistance, please refer to the Blackboard documentation.

To add the Echo360 URL into the default policy "white list" for iframes in Blackboard

  1. Log into Blackboard as an administrator and open the Admin panel.
  2. In the Security block, select Safe HTML Filters.
    Blackboard Admin panel with Security block and Safe HTML Filters selection identified for steps as described
  3. In the Safe HTML Filters page, select Safe HTML filter for Content Editor.
    Safe HTML Filter for Content Editor option identified for selection as described
  4. Download the existing default-policy.xml shown on the page.
    default-policy.xml file shown with Download option identified for steps as described
  5. Open the XML in a text editor or XML editing program.
  6. Search for iframe in the XML document. Find the iframe tag name validate action entry as highlighted in the below figure.
  7. In the TOP of the src attribute regexp list, add an entry with the following value: <regexp value="/webapps/echo-library-[A-Za-z0-9_]+/.*" />‚Äč
    THIS entry locks down videos submitted by students as a response to an assignment. SKIP THIS STEP if you do not want student assignment submissions to be locked.
    XML file open with iframe tag name  entry identified and src attribute list shown for steps as described
  8. Scroll to the bottom of the list of  regexp values (URLs) for iframes identified in the above figure. 
  9. Add an entry for Echo360 as follows, replacing with your regional URL if it differs (,,
    <regexp value="http[s]?://*" />  
    XML file with added Echo360 entries shown including all Echo360 regional URLs
  10. Save the edited XML file. You can retain the default name or you can give it a different name to delineate it from the original.
  11. Return to the Blackboard screen where the default-policy.xml file is listed, and click Upload.
    Blackboard Safe HTML filters page with Upload button identified for edited XML file as described
  12. Select the edited XML file and upload it to Blackboard. The new file will not overwrite the original; if you did not rename it, you will see multiple default-policy.xml files in the list. 
  13. SUGGESTED: Provide a description with the newly uploaded file that identifies what changed in the edited file. An example description is shown in the below figure.
  14. Click the menu arrow for the newly uploaded xml file and select Activate
    newly uploaded XML file shown with description provided and Activate option identified

Once Activated, the updated XML file is the new policy applied to the content editor window and will allow students to embed videos from their Echo360 content library. REMEMBER that in order for students to embed videos, the Student Library must be enabled, and the Student toggle for Embeddable and Public Links must also be enabled for the institution.
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
Invalid characters found