ArcGIS Enterprise

Send email from web map pop-ups

Email can be sent directly from web map pop-ups using pop-up configurations. Which configuration approach is best will be determined by how the email addresses are stored in the layer attributes. This post shows you how to send an email directly from a pop-up, and covers two examples of how the email might be stored; as an email address (somebody@company.com), and as a mailto link (mailto:somebody@company.com?subject=Hello).

You can follow along using a sample web map, click Modify Map or save a copy of the map to your account before you begin.

The map contains two layers; Office Location (original) and Office Location (configured).

The original layer does not have a configured pop-up, it’s the default and unimproved display of attributes. Use this layer to follow along with the instructions below. The configured layer uses a configured pop-up using all the email options described in this post.

*
The unconfigured pop-up

Click the symbol on the map to display the pop-up. In the original pop-up, shown below, the email address is stored in two ways. The Email field stores the address as a string in the format somebody@company.com. The Mailto Link field stores the address as a string in the format mailto:somebody@company.com?subject=Hello.

Note that both are displayed as text strings, rather than links. Using the techniques described below, the pop-up can be configured to use both variations on the email strings as clickable email links in the layer pop-up.

*
Configuring the pop-up

In the map Contents, move your mouse over the layer name to highlight it, and click the layer context menu (the dots) to reveal More Options.

Choose Configure Pop-up from the options list. This will display the Pop-up properties.

Using the pop-up properties, the pop-up can be configured in a variety of ways to enable an email link from the pop-up window. Follow the steps below.

*
Case 1: Email stored as a mailto link

The Mailto string can be configured as a mailto link in the pop-up using two methods; the first is using a custom attribute display, the second uses a link from an image.

*
Method 1 – Using a custom attribute display

Step 1. From the Pop-up Properties choose A custom attribute display.

Step 2. Click Configure.

Step 3. Along with other desired text and attributes, enter a text string to use for the email link and select it.

Step 4. Click Create Link to add a link to the selected text.

Step 5. In the URL input, enter the field name containing the mailto string using the curly braces – in this case the field is {Mailto}.

Tip: you can add the mailto field to your custom attribute display, then cut and paste it into the URL input instead of typing. You will notice a warning, but the warning can be disregarded.

Step 6. Set the Link Properties.

Step 7. Click OK, then save the pop-up configuration and map. The pop-up now includes the mailto attribute as a clickable link.

*
Method 2 – Using an image link

Step 1. From the Pop-up Media section of Pop-up Properties choose Add Image.

Step 2. In Configure Image add a Title and Caption as desired.

Step 3. Choose a field for the URL. This field contains a URL to an image that will be displayed in the pop-up, in this example it is an icon of a envelope.

Step 4. Add the field containing the mailto string to Link.

Step 5. Click OK.

Step 6. Save your pop-up configuration and your map. The pop-up now includes an image which can be clicked, or tapped if using a device, to send an email.

*
Case 2: Email stored as address string

If the attribute field contains a standard email address string (somebody@company.com) a mailto link can be configured in the pop-up using two methods shown below.

Method 1 – Using a custom attribute display

Step 1. From the Pop-up Properties choose A custom attribute display.

Step 2. Click Configure.

Step 3. Along with other desired text and attributes, enter a text string for the email link and select it.

Step 4. Click Create Link to add a link to the selected text.

Step 5. In the URL input, type the properly formatted mailto link using the field name containing the email address – in this case the field is {Email}.

Tip: You can add the email field to your custom attribute display, then cut and paste it into the URL input instead of typing it in.

Step 6. Set the Link Properties.

Step 7. Click OK, then save the pop-up configuration and map. The pop-up now includes a clickable link using the email address string.

*
Method 2 – Using an image link

Step 1. From the Pop-up Media section of Pop-up Properties click Add, then choose Image.

Step 2. In Configure Image add a Title and Caption as desired.

Step 3. Choose a field for URL. This field contains a URL to an image that will be displayed, in this example it is a thumbnail image of a letter.

Step 4. Add the field containing the mailto string to Link.

Step 5. Click OK.

Step 6. Save your pop-up configuration and your map. The pop-up now includes an image which can be clicked, or tapped if using a device, to send an email.

*
Summary

Using the sample map, turn off the original layer and turn on the configured layer.

Click the point location on the map to view a pop-up configured with all the options described above.

*
More information

Custom attribute displays and links from images in pop-ups provide opportunities to customize the capabilities presented in pop-up, including the ability to create a link to send an email.

For more information see Configure pop-ups.

This post was originally published on October 1, 2015, and has been updated.

About

Tech evangelist and product strategist at Esri, focusing on ways to broaden access to geographic information and helping users succeed with the ArcGIS Platform. On a good day I'm making a map, on a great day I'm on one. Follow @bernszukalski or email bszukalski@esri.com

Next Article

What Kind of Data is Available in ArcGIS Online?

Read this article