Embed videos in the HTML editor

  • Release version: Australia
  • Updated June 2, 2026
  • 2 minutes to read

    • 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 resolution Recommended 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:
    Table 1. Optimal viewing settings
    Type Definition
    Size 20MB
    Bit rate 320KBPS
    Resolution 480*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 (Insert or edit video) on the HTML editor toolbar.
    4. Enter information in each field.
      Table 2. Insert/Modify Video
      Field Description
      Type Select 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.
      Size Enter the Width and Height of the video in pixels.
    5. 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.