Skip to content
Release: Australia · Updated: 2026-06-02 · Official documentation · View source

Embed videos in the HTML editor

You can insert videos into HTML fields. You can also add videos to the video library using the HTML Insert/Modify Video form.

Before you begin

Note: The Videos [db_video] table is a public table that does not have any security restrictions. Unauthenticated users have full access to videos uploaded to the db_video table.

Role required: The role necessary to update the record that contains the HTML field. For example, any user with a role can create a knowledge article and embed a video in it.

About this task

The following file formats are supported in the base system.

  • MPEG-4 video .mp4
  • WebM Video .webm

The larger the file size, the longer it takes to download before the video starts. To reduce file size, you can reduce the bit rate, but doing so reduces the quality of the video. The following bit rates optimize download speed and video quality:

Video resolutionRecommended bitrate
Standard definition (480p)1.5–2.5 megabits per second (mbps)
High definition (720p)3–5 mbps
High definition (1080p)6–8 mbps

Note: For the best viewing experience the following specifications are suggested:

TypeDefinition
Size20MB
Bit rate320KBPS
Resolution480*320

Internet Explorer and Safari have difficulty streaming videos uploaded to the database. Attach a file rather than embedding if you intend to use one of these browsers or an unsupported file type. For more information on attaching files, see Add and manage attachments.

Note: Administrators and users with the image_admin role can manage the video library at System UI > Videos.

Procedure

  1. Open the form that contains the HTML field.

  2. Select the position where the video is to appear, or to modify an existing video, select the video.

  3. Select the insert/edit video icon (

Image omitted: TinyMCEV4Video.png
Insert or edit video\) on the HTML editor toolbar.
  1. Enter information in each field.
FieldDescription
TypeSelect the video type.- Video Library: List of videos stored in the db_video table. You can reuse it. - URL: from an external source - Attachment: available in the current record only For an attachment or video library file, select a video from the list or select New. For an external URL, enter the URL.
SizeEnter the Width and Height of the video in pixels.
  1. Select OK.

What to do next

Note: You can also add and use an HTML video in portal content, see the following steps for how this works.

  1. Upload a video to db_video table.
  2. Create Link content record of type Video with URL with syntax (Videoname.extension, Example: Escx_test.mp4)
  3. Create the portal video content, choose the newly produced video, and publish it to the desired widget.
  4. Preview the content you created in the portal widget you published it to.