Skip to main content

HTML Email Builder

The HTML Email Builder component takes an HTML payload and wraps it into a clean, styled email body ready to send. It optionally embeds a footer logo as a base64-encoded image so the email is self-contained with no external image dependencies.

Use this component at the end of a flow that generates HTML content — for example, after an LLM produces a formatted report — to produce a send-ready email body.

Accepted payload formats​

The Parsed Payload input accepts HTML in several forms:

  • A raw HTML string: <div>Hello</div>
  • A markdown-fenced HTML block: ```html\n<div>Hello</div>\n```
  • A dictionary with an html, content, body, or text key
  • A JSON-encoded or Python-literal string of such a dictionary

Use the HTML Email Builder in a flow​

  1. Add an HTML Email Builder component to your flow.
  2. Connect a component that produces HTML content to the Parsed Payload port. This is typically an LLM or Structured Output component.
  3. (Optional) To enable a footer logo, toggle Show Footer Logo on and enter the absolute path to the logo image in Footer Logo Path (for example, /mnt/gcs/logo.png).
  4. (Optional) To disable the component conditionally, connect an If-Else output to the Enable Component field. When the connected value is false, the component passes through an empty message.
  5. Connect the Email Body (HTML) output to a component that sends email.

HTML Email Builder parameters​

Some parameters are hidden by default in the visual editor. You can modify all component parameters through the component inspection panel that appears when you select a component.

NameTypeDescription
Parsed Payload (HTML)DataInput parameter. The HTML content to embed in the email body. Accepts raw HTML, a dict, or a JSON string.
Enable ComponentTextInput parameter. Advanced. Controls whether the component runs. Accepts true/false or an If-Else output connection. Defaults to true.
Show Footer LogoBooleanInput parameter. Advanced. When enabled, a footer logo is embedded at the bottom of the email. Requires Footer Logo Path. Defaults to true.
Footer Logo PathTextInput parameter. Absolute path to the footer logo image file (for example, /mnt/gcs/logo.png). Required when Show Footer Logo is enabled.
Email Body (HTML)MessageOutput parameter. A fully wrapped HTML email body, ready to send. Returns an empty message when the component is disabled.