Creating an HTML Page as Training Material

Learn how to create an HTML page in your courses

Last Updated

October 27th, 2020

Docebo Module


Reading Time

4 min

User Level


In your learning platform, you can embed videos, text, and pages from other websites into specific text boxes for HTML page training material, thus making your training material engaging for your users. This article outlines how to embed videos or iFrames from other websites into HTML Page training material.

Please note: You can link videos from YouTube, Wistia, and Vimeo as video training material without using the HTML page training material.

Creating an HTML Page Training Material

Begin by logging into your platform as the Superadmin. Then, access the Admin Menu from the gear icon in the top right corner. Then, in the E-Learning section, click on the Course Management item. Now, on the main Course Management page, find the course in which you want to upload a training material from the list of courses, click on its description and move to the Training Material tab.

Press the Add Training Material button. From the dropdown menu, select HTML Page. On the upload page, begin by typing in a title and description into the corresponding text boxes. For the description, you can edit the text as necessary. Now, you can insert videos, photos, or iFrames as desired.

Inserting Videos or Photos into HTML Page as Training Material

Press the Insert Video button in the markup toolbar at the top of the description text box. In the pop-up box, fill out each text box as necessary:

  • Source. The video’s URL.
  • Alternative Source. An alternative URL for the video.
  • Poster. An image that will be displayed before playing the video. It will be the cover image of this training material. Press the folder icon next to the text box to upload an image. Once you select the image, press Insert.
  • Dimensions. You can set your own dimensions for the training material, if necessary. You can also flag the option to constrain proportions.

Alternatively, you can click on the Embed tab at the top of the pop-up box to configure the code of the video. When you’re finished, press the OK button at the bottom of the pop-up box. The video will now appear in the description text box for the training material. You can resize the video using the squares on the corners of the video.

html page create

You can then move to the Additional Info tab, where you can insert a short description of the training material and select a thumbnail. You can also upload a thumbnail, if desired.

You can also add tags to your training material to improve its searchability in your platform’s global search. Some tags may be automatically generated based on the content of your asset, as understood by your platform using artificial intelligence (note that this only works for English, Spanish, French, German, Italian and Portuguese content). You can edit or remove tags at any time, with a limit of 15 tags per training material (find out more about taggable content types). Please note that, for security reasons, the platform artificial intelligence does not access private content (that is, content requiring authentication to be accessed) and can thus automatically generate tags only for public content. When uploading private content, we suggest you add tags manually.

Now, press Save Changes to create the training material, which will now appear in the list of training materials on the course’s Training Materials page. You can switch to learner view by using the Learner View button in the action bar at the top of the Training Materials page. In the learner view, you can view how your new training material appears to your users.

Adding iFrames to HTML Pages as Training Material

You can also add iFrames to your HTML Page training material, so you can show different web pages inside your courses. Once you’re on the upload page for the training material, add a title and insert text into the description text box, as necessary.

HTML page

In order to add an iFrame into the training material, you must first insert the URL you are planning to include in the list of URLs allowed within your platform. To do so, access the Admin Menu, then press the Advanced Settings item from the Settings Section. In the Advanced Settings menu, select the E-Learning tab. In the IFrame Allow List section, type the URL into the corresponding text box, then press Add. It will now be properly displayed in your platform. Please note that URLs on the allow list do not accept wildcard characters, such placeholders as (*).

Once you’ve added the URL to your allow list, you can insert the iframe into your HTML object. In the description box on the upload page for the training material, choose the Source code icon.

html page source code

Then, insert the URL between the following tags

<iframe src=""></iframe>

and replace with the URL you want to insert in the iframe. Please remember that the object will be marked as completed when the user closes the page using the ‘X’ close button at the top of the page for the training material.

Best Practices

Keep the following best practices in mind when creating and managing an HTML page:

  • Use it in a course as the first element, in order to create an introduction to your course. The main difference between an HTML page and a Course Description widget is that in the first case the introduction will be immediately visible without scrolling down the page.
  • Use it to provide instruction about how to use training material.
  • Use it when you want to show an external website or page to the user.