Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Embed images in the HTML editor

You can use the HTML field image picker to embed images into HTML fields, and to add images to the image library.

Before you begin

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 an image in it.

About this task

Note: Administrators and users with the image_admin role manage the image library at System UI > Images. See Storing images in the database .

Procedure

  1. Open the form that contains the HTML field.

  2. Click the position where the image is to appear, or to modify an existing image, click the image.

  3. Click the insert/edit image icon (

Image omitted: TinyMCEV4Image.png
Insert or edit image icon\) on the HTML editor toolbar.
  1. In the Insert/Modify image form, enter information in each field.
FieldDescription
TypeSelect the image type.- Image Library: Images stored in the db_image table. You can reuse images in the image library in multiple locations. - Attachment: Available in the current record only
Image

Begin typing a file name and select an image from the list, or click the reference lookup icon and select an image.To upload a new image, click New, click Choose File, locate the image, and click Upload.

If you chose the Attachment type, click Choose File, locate the image, and click Attach.

TooltipEnter alternate text that appears when a user points to the image.
AltEnter alternate text that can be used to improve accessibility. For example, it could be used with a screen reader. If this field is left blank, it defaults to the text entered in the Tooltip field.
**Note:** To resize an embedded image, click the image. The sizing frame appears. Drag a sizing point until the image is the desired size. Corner points adjust the size proportionally. Depending on your browser, you may need to highlight the image before the sizing frame appears.
  1. To provide additional control over the appearance of an image, click Advanced options.

    FieldDescription
    LayoutSelect the image Alignment (default is Baseline) and enter the Border thickness.
    SpacingEnter the number of Horizontal and Vertical pixels around the image.
    SizeEnter the Width and Height of the image (in pixels).
  2. Click OK.

  3. Paste an image into the HTML editor.

    To edit the image, save the entry then select the image. Click the insert/edit image icon and complete the form using the same tables for adding an image.

    Pasted images are saved in the system as attachments.