A new feature of Crossware Mail Signature V4 onwards is Image Lookups. Image Lookups allow signature designers to insert images directly into an email.


Image lookups will insert in the images directly into the body of an email. The images must be stored as uncompressed attachments in a Notes Document.

To help store the images the signature configuration also includes an Image Library to store images.

Rich Text Emails

The image will be copied into the Rich Text body of the email and transferred with the email. The image will be placed at the position of the (!lookup!)



The image will be copied into the HTML email, the MIME boundaries will be created/updated and an image tag will be created in place of the (!Lookup!) text.

MIME/Plain Text Emails

If image lookups are used in Plain Text signatures e,g, the plain text signature is automatically created from the Rich Text signature, then the (!lookup!) will return an empty string.


Possible uses form Image Lookups

Common Images across many configurations

The same image can be used in many signature configurations.

Updating the image in the Image Library will update the image in all signature configurations.

Employee images

The image lookup allows the selection of the filename or the document containing the image to be generated at runtime.

Therefore, if the employee image is stored in the person document with a common filename e.g. "user.jpg" different images can be inserted based on the sender.

Creating Image Lookups

To create a new image lookup create a new lookup, assign the lookup a name and select the type Image


Form Field


Lookup Name

This is the name of the lookup that will be referenced in the signature configuration e.g, (!IMG_Facebook!)


This will be set to Image for Image Lookups

Image Source

The image source field controls where the image will be extracted from.

a. Signature Library: The lookup will extract the images from the esig.nsf database Image Library

b. Custom: Allows the signature designer to specify the database, view and document key where the image attachments reside.


Image Database

The name of the database that contains the image.

Image View

The view within the above database to be used to find the Notes Document containing the image

Image Key

This is the key used to find the document. In the above example a lookup is used to find the Notes Document

Image Name Type

a. Text: The name of the image attachment in the Notes Document

b. Use Lookup: A lookup may be selected to calculate the image name. This lookup should return a text string that matches the attachment name.


"(!FirstName!)" + "(!LastName!)" + ".gif" will give "JoeBloggs.gif"

Image HTML Attributes

Additional attributes for HTML for controlling the formatting of the image. This text string is copied to the attribute parameter of the IMG tag.

Related Products: CMS DOM v4, CMS DOM v5

Articles Mentioned (1)