We're sorry Aspose doesn't work properply without JavaScript enabled.

Free Support Forum - aspose.com

Images in a Merge Field

Can anyone/someone let me know if it's possible to insert a bitmap/jpeg, etc. into a merge field? If so, can you please provide a code sample for doing so.

Thank you in advance,


Hi Anthony,

Thanks for your inquiry. To be able to insert images at a merge field, you first need to configure merge field’s name according to the following syntax in your template document:


Secondly, you can simply use the following code snippet to insert images during mail merge:

//Create array with field names and array with field values<o:p></o:p>

string[] names = { “MyFieldName” };<o:p></o:p>

object[] values = { File.ReadAllBytes(@“Common\test.jpg”) };<o:p></o:p>

//Open template<o:p></o:p>

Document doc = new Document(@“Test040\in.doc”);<o:p></o:p>

doc.MailMerge.FieldMergingCallback = new HandleMergeImageFieldFromBlob();

//Execute mail merge<o:p></o:p>

doc.MailMerge.Execute(names, values);<o:p></o:p>

//Save output document<o:p></o:p>


private class HandleMergeImageFieldFromBlob : IFieldMergingCallback
void IFieldMergingCallback.FieldMerging(FieldMergingArgs e)
public void ImageFieldMerging(ImageFieldMergingArgs args)
if (args.FieldName.Equals(MyFieldName))
DocumentBuilder builder = new DocumentBuilder(args.Document);

builder.InsertImage(args.FieldValue.ToString(), 200, 200);

Moreover, you can find documentation of DocumentBuilder.InsertImage method overloads here:

I hope, this helps.

Best regards,


Thank you for the code. I'm testing within an ASP.NET MVC Web application and the ImageFieldMerging callback is never fired/executed. Is there an alternate means to making this code work on a Web page?



Awais, just wanting to be clear that we are using ASP.NET MVC 4.0 (and NOT classic ASP OR ASP.NET Web Forms) so the solution would need to be able to work in that context.

Update, I got the signature to work by removing the property set of FieldMergingCallback and putting the code in the ImageFieldMerging method directly after the Execute call of MailMerge. In addition, I removed the field name and value from the fieldnames and fieldvalues arrays.

Hi Anthony,

It’s great you were able to find what you were looking for. Moreover, you can also use the following simple code to manually move cursor to a position just beyond the specified merge field, remove the merge field and insert image there.

Document doc = new Document(@"C:\Temp\in.docx");
DocumentBuilder builder = new DocumentBuilder(doc);



Please let us know any time you have any further queries.

Best regards,