Skip to main content
Content menu: Images

Everything you need to know about adding images to your email content

Katy Moore avatar
Written by Katy Moore
Updated over a year ago

In this article:


Working with images in the email editor

Images are a crucial part of engaging email content. Using the image icon in the content menu in Shaman, you can quickly and easily add images to your email content.

You can also use the handy image editor in Shaman to make changes to your images before adding them to your email. You can read more about working with the image editor here.


How to add an image to your email content

Let´s imagine that you have created a new email fragment or template, have completed the email details, and are now in the HTML editor ready to add elements to your email fragment or template. (If you need to revise any of these steps, check out this article here).

From the menus on the right-hand side, select the content menu. Find the image icon in the content menu, and simply drag and drop that icon onto your email canvas.

You will notice that a grey placeholder image has been added to the email canvas. To add your own image to the email canvas instead, click the Update image button from the menu on the left-hand side.

You will then be redirected to your image library. Here, you will find all images previously uploaded to your account (you can use the search bar or time filters to find content easier).

Or you can upload a new image. To do this, click the upload button and then select an image file from where it is stored on your computer. You will then be redirected to the image editor, where you can make any changes or annotations to the image you have uploaded before adding it to your email content.

Good to know!

You will be redirected to the image editor only when you upload new images from your computer or drive. The image editor will not be displayed when you select existing images from your image library.

Once you are happy with the changes made, you can click “Save” to save your image and add it to the email editor. You will then be redirected back to the email canvas, where the image uploaded will be added to the email canvas.

Using the menu on the right-hand side, you can then define additional optional settings for the image.

Auto Width: This setting is a toggle that sets an image automatically to fit the width of your email content. To set the width of an image manually, you can disable the auto width toggle and use the slider to resize your image bigger or smaller.

Align: This setting allows you to define the alignment of your image in relation to your email content by selecting from the left, center, right, or full alignment icons.

Alternate Text: Alternative Text is meant to convey the “why” of the image as it relates to the content of a document or webpage. It also displays on the page if the image fails to load.

If you wish to have alternative text for your image, you can add it to this field simply by typing directly into the box available. (As a default, this field will be populated with “Countdown”.)

Action: Here you can add an action such as if the email recipient clicks on the image, a specific webpage will be opened. There are several options to choose from in the dropdown menu on the right-hand side (which shows “Open Website” as a default action).

  • Open website

  • Send email

  • Call phone number

  • Send SMS

Depending on which option you choose, additional fields will be displayed to further personalize the action. For example, if you choose the “Open Website” option, you will need to populate the URL link in the field provided. You can also define whether a new tab is opened, or if the webpage is viewed on the same tab in the reader's browser.

Top tip!

When using the “Open website” option, we always recommend you copy the URL directly from the browser before pasting it in this URL field to avoid any typos or incorrect links.

You may also see “Special Links” in blue on your actions menu. The image will then contain the information held in the token that is automatically populated in the menu on the right-hand side.

The following special link tokens are available to use here:

Document links:

  • Related Piece {{PieceLink}}: This token will direct the reader of the email to a Veeva-hosted promotional-related document known as “Related Piece”. This document needs to be uploaded, approved for distribution, and attached to the host email content manually in Veeva Vault for the token to work successfully. You can learn more about the related piece token here. +LINK

  • Product Information {{PILink}}: This action will direct the recipient to a Veeva-hosted prescribing information-related document known as “Related PI”. Similar to related piece documents, the related PI also needs to be uploaded, approved for distribution, and attached to the host email content manually in Veeva Vault.

  • Vault Document (Add ID){{$VaultDocID}}: This action will direct the recipient to a Veeva-hosted Other Links-related document known as “Other Related Document”. Similarly to related piece documents, this also needs to be uploaded, approved for distribution, and attached to the host email content manually in Veeva Vault.

Meeting links:

  • Engage meeting: {{engageLink}} This action will direct the recipient to join an Engage meeting.

  • Zoom meeting: {{insertEngageAndZoomJoinURL]}} This action will direct the recipient to join a Zoom meeting.

Unsubscribe product link: {{unsubscribe_product_link}} This action will direct the recipient to a page where they can unsubscribe from receiving product information.

Container Padding: Padding can be used to perfectly position images within the body of your email content. You can choose to add the same padding to all sides by maintaining the “All sides” toggle enabled. Or, you can disable this toggle to manually configure the padding size for each side of the image. You can use the plus and minus icons to increase or decrease the padding, or you can type a numerical value directly into the padding box.

Hide on Desktop: When this toggle is enabled, the image will not be displayed when viewing the email on a desktop computer or laptop, it will only be viewable on a mobile view.

Good to know!

We highly recommend you pay attention to how your email content looks on both mobile and desktop views. To learn more great tips when creating email content compatible with mobile and desktop views, take a look at this article here.


How to update an existing image with a new image

If you want to change an image that has already been added to the email canvas, select the image by clicking on it. Then, from the menu on the left-hand side, click the “Update Image” button.

You will be redirected back to the image editor, where you can either click “Upload image” to upload a new image to the image library or if you have already uploaded the image you can find it in the image library by using the search filters available.

Once you are happy with the changes made, you can click “Save” to save your image and add it to the email editor. You will then be redirected back to the email canvas, where the image uploaded will be added to the email canvas.


How to delete or duplicate an image

To delete an image, simply click the image to select it. You will then notice two icons - a bin icon to delete the image, and a copy icon to duplicate it.

Depending on which you wish to do, simply click the icon, and your image will either be deleted or duplicated.

Did this answer your question?