HtmlForgeX

Attachments

Image Embedding

Base64 Data URI

email.EnableImageEmbedding(timeout: 30, optimize: false);

CID Inline Attachments

email.EnableInlineImageAttachments(timeout: 30);

Image Optimization

email.ConfigureImageOptimization(maxWidth: 800, maxHeight: 600, quality: 85);

ICS Calendar

Generate iCalendar (.ics) attachments:

var calendar = new EmailIcsCalendar();
calendar.WithMethod(EmailIcsMethod.Request)
        .WithFileName("team-meeting.ics")
        .AddEvent(new EmailIcsEvent()
            .WithSummary("Team Meeting")
            .WithDescription("Weekly team sync")
            .WithLocation("Conference Room A")
            .WithWhen(
                new DateTimeOffset(2026, 2, 15, 10, 0, 0, TimeSpan.Zero),
                new DateTimeOffset(2026, 2, 15, 11, 0, 0, TimeSpan.Zero)));

var calendarBytes = calendar.ToBytes();
var calendarFileName = calendar.FileName;
var calendarContentType = calendar.ContentType;

VCard

Generate vCard (.vcf) contact attachments:

var vcard = new EmailVCard();
vcard.WithName("John", "Doe")
     .WithFileName("john-doe.vcf")
     .AddEmail("john@example.com", EmailVCardEmailType.Work, preferred: true)
     .AddPhone("+1-555-0123", EmailVCardPhoneType.Cell, preferred: true)
     .WithOrganization("Acme Corp")
     .WithTitle("Customer Success");

var vcardBytes = vcard.ToBytes();
var vcardFileName = vcard.FileName;
var vcardContentType = vcard.ContentType;

Using Attachments

Inline image resources are included in the render result:

var result = await email.RenderAsync();
// result.Html contains the rendered email HTML
// result.InlineResources contains CID attachments for embedded images

Calendar and vCard payloads are exported separately, then attached with your mail library using the suggested FileName , ContentType , and ToBytes() values shown above.

API Reference