Configure pop-ups (Map Viewer)

A map can show descriptive information about imagery and features configured to display in a pop-up. Pop-ups can bring focus to the attributes associated with each layer in the map, such as hiking trails, land use types, or unemployment rates. They can contain attachments, images, charts, and text, and they can link to external web pages.

Tip:

For point layers with clustering enabled, you can also configure pop-ups for clusters.

In Map Viewer, the default pop-up appearance for a feature layer is a list of fields and values. The default pop-up appearance for an imagery layer is the pixel values. As a map owner, you can reconfigure the pop-ups to define the list of visible and hidden fields, and define how the information is presented. You can also add content to provide more meaning to the pop-up. For example, you can include a list of fields, provide an interactive experience using custom-formatted text and images, and show related records.

Tip:

To learn more about designing and configuring pop-ups, see the following blog articles:

• Pop-ups: the essentials
• Pop-ups: text element essentials
• Pop-ups: image essentials
• Pop-ups: chart element essentials
• Pop-ups: Arcade essentials

Configuration options

As a map author, the main decisions you'll make about pop-ups are what information is displayed and the best way to present it. For example, to show the public where they can swim, fish, and boat along the Mississippi Gulf Coast, you can configure pop-ups to show the address, type of access, and images of public access points. Even though the layer may have other fields regarding the location and type of point, you may not want to show them in the pop-up, as the public won't be interested and they detract from the more relevant information.

Depending on what you are trying to show in pop-ups for feature or imagery layers, you can choose from a variety of configuration options. These are described in the sections below.

Tip:

Some configurations are illustrated in this map of California peaks. On the Contents (dark) toolbar, click the Layers pane and turn on one layer at a time to compare the configurations by clicking features on the map.

Enable and remove pop-ups

Layers can contain a large amount of feature data, and maps can include several layers, so pop-ups generally look better if you configure them with selected fields, formatting, media, and so on. Pop-ups are enabled on feature layers by default.

To remove pop-ups from a layer, complete the following steps:

1. Confirm that you are signed in and, if you want to save your changes, that you have privileges to create, update, and delete content.

   Note:

   You can explore maps, add and configure layers, and more without signing in. To save your work, sign in before creating a map.

2. In Map Viewer, open the map containing the layer or add the layer directly.
3. On the Contents (dark) toolbar, click Layers to open the Layers pane, and select the layer that contains the feature data you want to show in a pop-up.
4. On the Settings (light) toolbar, click Pop-ups , and turn off the Enable pop-ups toggle button.

To enable pop-ups on a layer with pop-ups turned off, turn on the Enable pop-ups toggle button.

Configure pop-ups

To configure pop-ups, complete the following steps:

Tip:

You can use keyboard shortcuts to quickly complete common workflows in Map Viewer. To view the full list of keyboard shortcuts in Map Viewer, press Alt+? on Microsoft Windows or Option+? on Mac.

1. Confirm that you are signed in and, if you want to save your changes, that you have privileges to create, update, and delete content.

   Note:

   You can explore maps, add and configure layers, and more without signing in. To save your work, sign in before creating a map.

2. In Map Viewer, open the map containing the layer or add the layer directly.
3. On the Contents (dark) toolbar, click Layers to open the Layers pane, and select the layer that contains the feature data you want to show in a pop-up.
4. On the Settings (light) toolbar, click Pop-ups .
5. Optionally, for imagery layers, turn on the Ignore NoData toggle button to disable pop-up information for NoData areas in the image.

   If the Ignore NoData toggle button is turned off, no pixel information will be displayed in the pop-up.

6. Optionally, for imagery layers, turn on the Display topmost item only toggle button to display pop-up information for the topmost layer in a mosaic dataset.

   If the Display topmost item only toggle button is off, pixel information for all the mosaic dataset layers at the location will be displayed.

7. Click Title and enter a title for the pop-up.
   1. Click Add field and select fields from the data.

      Note:

      To display information derived from an ArcGIS Arcade expression in the pop-up title, add a new expression. The new expression appears in the list of fields.

   2. Optionally, enter static text instead of or in addition to the field values.

   For example, you want the title to show population by county. You can configure the title with a combination of static text and field values, such as typing Population for; inserting the data's field value of county names {Cnty_name}; typing the equal sign =; and inserting another field value that shows population, {pop2010}. This configures the title as follows:

   Population for {Cnty_name} = {pop2010}

   This provides a title in which the field values are substituted into the title, for example, Population for Clark County = 453099.

8. Click Fields list.
9. Enter a title for the list of fields shown in the pop-up.
   1. Click Add field and select a field value or expression from the data. Use this option if you want a unique title for each feature in the data.
   2. Optionally, enter static text instead of or in addition to the field value.
   3. Leave the field blank if you don't want a title for the fields list.
10. Enter a description for the list of fields.
    1. Click Add field and select a field or expression from the data. Use this option if you want a unique description for each feature in the data.
    2. Optionally, enter static text instead of or in addition to the field values.
    3. Leave the field blank if you don't want a field description.
11. Rearrange and remove fields, and click Select fields to add fields to the list.

    You can configure the fields to better display the field names and values.

    If the feature layer includes attachments, they are automatically added to the pop-up under attachments. Attachments are supported as a related table to a feature class in a feature service.

12. Optionally, click Add content and add media such as images, charts, or text to the pop-up.
13. Optionally, use the Reorder handles to change the order in which the content appears.
14. On the Contents toolbar, click Save and open and click Save to save the pop-up changes to the map.

Configure fields

You can configure the field or fields you want to display by changing the display name and formatting the display properties.

1. On the Settings (light) toolbar, click Fields .
2. Select the field you want to configure.

   Tip:

   You can select multiple fields of the same type to configure their formatting at the same time.

   1. Change the display name of the field.
   2. For number fields (such as population), select the number of decimal places to display and whether to use a thousands separator.
   3. For Date, Date only, and Timestamp offset fields, select a date format from the Date format drop-down menu.
   4. For Date and Timestamp offset fields, turn on the Show time toggle button and select a format for displaying time.
   5. For a Time only field, select a time format from the Time format drop-down menu.

   Note:

   To learn more about supported field types, see Date and time fields in ArcGIS Online.

3. Click Done.

Use expressions

You can use custom expressions written in the Arcade expression language when configuring pop-ups. Using expressions allows you to create and display new information from existing fields in the layer. For example, you can create an expression that converts values from feet to meters, or dynamically create a URL based on feature attributes. If an expression is available for the layer—for example, for labeling or styling—you can copy and reuse it in your pop-up configuration.

You can create expressions in pop-ups or use existing expressions created for the layer.

1. Follow the first four steps in the Configure pop-ups section to open the Pop-ups pane for the layer you want to configure.
2. Click Attribute expressions.

   The Attribute expressions pane appears.

3. Click Add expression to open the editor window and create the expression.

   Tip:

   If you need help with any of the Arcade functions, click the arrow next to the function to see reference information about it.

4. In the editor, click Done when you're finished.

   Tip:

   Before closing the editor, give the Arcade expression a title that makes it easily identifiable in the list of fields.

   The new expression is added to the Attribute expressions list. To edit it, select it from the list and make changes in the editor. To remove it, click Remove expression next to it.

   If you used a list of field attributes in the pop-ups, the new expression is added to the Fields list section, and you can change its formatting in the Fields pane.

5. On the Contents (dark) toolbar, click Save and open and click Save to save the pop-up changes to the map.

Add attachments

When a feature layer includes attachments in its data, the attachments are added to the layer's pop-up. You can show the attachments as a list or in a gallery. You can also remove attachments from the pop-up. Clicking attachments in a pop-up opens the attachment in a new browser tab.

Note:

If pop-ups have not been previously configured for the layer and you are configuring the pop-ups in your map for the first time, Map Viewer automatically chooses the most appropriate display for your attachments.

1. Follow the first four steps in the Configure pop-ups section to open the Pop-ups pane for the layer you want to configure.
2. Click Attachments.
3. Enter a title for the attachment.
   1. Click Add field and select a field value or expression from the data. Use this option if you want a unique title for each feature in the data.
   2. Optionally, enter static text instead of or in addition to the field value.
   3. Leave the field blank if you don't want a title.
4. Enter a description for the attachment.
   1. Click Add field and select a field or expression from the data. Use this option if you want a unique description for each feature in the data.
   2. Optionally, enter static text instead of or in addition to the field values.
   3. Leave the field blank if you don't want a description.
5. Optionally, turn on the Show as list toggle button to show the attachments in a list.
6. Optionally, click Options and click Delete to remove attachments from the pop-up.
7. On the Contents (dark) toolbar, click Save and open and click Save to save the pop-up changes to the map.

Add images

You can include images in pop-ups by providing a URL to an image (PNG, JPEG, or GIF format). The images can include a title, caption, links to related websites, and alternative text.

Tip:

For the best display, create images that are 400 pixels wide and optimized for web use. If the width of the image is less than 400 pixels, a white border is visible in the window. If the image is wider and not optimized for web use, the web browser automatically rescales the image and it may appear warped.

When adding images to pop-ups, you can set a refresh interval. This allows the pop-up to refresh and display a frequently updated image at a specific interval (in minutes). For example, you can use this option to refresh images captured by a traffic camera.

1. Follow the first four steps in the Configure pop-ups section to open the Pop-ups pane for the layer you want to configure.
2. Click Add content and choose Image.
3. Provide the URL to the image.
   1. Click Add field and select a field or expression from the data. Use this option if you want a unique image for each feature in the data.
   2. Optionally, provide the URL to an image stored on an external website, in ArcGIS Online, or as an attachment in the layer's data. PNG, JPEG, and GIF formats are supported. If the image is stored as an item in ArcGIS Online, you must provide the URL copied from the URL field on the item page, which is only available if the image item is shared with the public.
4. Click Options to reveal additional fields for the title, caption, link, and refresh interval.
5. Enter a title for the image.
   1. Click Add field and select a field value or expression from the data. Use this option if you want a unique title for each feature in the data.
   2. Optionally, enter static text instead of or in addition to the field value.
   3. Leave the field blank if you don't want a title.
6. Enter a caption.

   The caption appears below the title and above the image. It is useful for giving a short explanation of the image.

   1. Click Add field and select a field or expression from the data. Use this option if you want a unique caption for each feature in the data.
   2. Optionally, enter static text instead of or in addition to the field values.
   3. Leave the field blank if you don't want a caption.
7. Enter alternative text for the image.

   Alternative text is hidden on the pop-up and is used by screen readers.

   1. Click Add field and select a field or expression from the data. Use this option if you want unique alternative text for each feature in the data.
   2. Optionally, enter static text instead of or in addition to the field values.
   3. Leave the field blank if you don't want alternative text.
8. Enter the URL of a related link.

   When the image is clicked, this URL opens in a new browser tab.

   1. Click Add field and select a field or expression from the data. Use this option if you want a unique URL for each feature in the data.
   2. Optionally, enter the URL of a related link.
   3. Leave the field blank if you don't want a related link.
9. Optionally, turn on the Refresh interval toggle button and enter a value in minutes in the text box to set a refresh interval for the image.

   When the pop-up is displayed, the image is refreshed at the interval specified.

10. Optionally, click the Reorder button next to the item in the Media section and drag it to a new position if you have more than one image (or other media items) and want to change the order in which they appear in the pop-up.
11. On the Contents (dark) toolbar, click Save and open and click Save to save the pop-up changes to the map.

Add charts

You can add charts to graphically display the values of numeric attribute fields. You can add bar charts, line charts, and pie charts.

1. Follow the first four steps in the Configure pop-ups section to open the Pop-ups pane for the layer you want to configure.
2. Click Add content and choose Chart.
3. Choose the type of chart you want to show.
4. Enter a title for the chart.
   1. Click Add field to select a field or expression from the data.
   2. Optionally, enter static text instead of or in addition to the field value.
   3. Leave the field blank if you don't want a title.
5. Enter a caption for the chart.

   The caption appears below the title and above the chart. It is useful for giving a short explanation of the data in the chart. You can include an indication of units for column, bar, or line charts in the chart description. A pie chart shows percentages when hovering over each segment.

   1. Click Add field to select a field or expression from the data.
   2. Optionally, enter static text instead of or in addition to the field value.
   3. Leave the field blank if you don't want a caption.
6. Enter alternative text for the chart.

   Alternative text is hidden on the pop-up and is used by screen readers.

   1. Click Add field and select a field or expression from the data. Use this option if you want unique alternative text for each feature in the data.
   2. Optionally, enter static text instead of or in addition to the field values.
   3. Leave the field blank if you don't want alternative text.
7. Click Select fields and select the fields to include in the chart.
8. Optionally, adjust the chart colors by doing the following:
   • For line charts, select a color from the color picker or specify a custom color using RGB, HSV, or hexadecimal values. Click Add to save a custom color and click Remove to remove a saved color. Click Done when you are finished selecting a color.
   • For bar charts and pie charts, select a color ramp and click Done. To filter the color ramp options, choose a color ramp category from the drop-down menu—for example, Best for dark backgrounds or Bright—and optionally click Flip ramp colors to change the direction of the colors in the ramp. Alternatively, click the colored symbol next to each field in the list to customize any of the colors individually.

     Tip:

     To see the name of a color ramp, point to it.

   Click Reset to default colors to return to the default chart colors at any time.

9. Optionally, turn on the Horizontal orientation toggle button to display a bar chart horizontally.
10. Optionally, turn on the Normalize toggle button and select a normalization field.

    The values in this field are used to divide the value field to create ratios. Normalization ratios are useful when other factors influence the numerical values you are classifying and displaying. For example, population can be influenced by each county's size, so you can divide population by area to standardize the data. Data normalization is also useful for providing a meaningful comparison if the values in the fields do not use the same units of measurement.

11. Optionally, click Reorder next to the item in the Media section and drag it to a new position if you have more than one chart (or other media items) and want to change the order in which they appear in the pop-up.
12. On the Contents (dark) toolbar, click Save and open and click Save to save the pop-up changes to the map.

Add text

You can include text in pop-ups to add context and information.

1. Follow the first four steps in the Configure pop-ups section to open the Pop-ups pane for the layer you want to configure.
2. Click Add content and choose Text.

   A text element is added and the text editor appears.

3. In the text editor, do any of the following:
   • Click Fields List or type { and select a field or expression from the data. Use this option if you want unique text for each feature in the data.
   • Enter plain text in the text editor.
   • Use the text formatting tools to format the text.

   Tip:

   To give you the most control and flexibility over your display, you can also use supported HTML in your pop-ups by clicking Source in the text editor.
4. Click OK.
5. On the Contents (dark) toolbar, click Save and open and click Save to save the pop-up changes to the map.

Add an Arcade element

In addition to using attribute expressions to return values that function like existing fields, you can use Arcade to create and define entire content elements in pop-ups. Using an Arcade element helps to avoid duplication of logic when working with multiple attribute expressions. Arcade elements allow you to define the data and other aspects of the element in a single expression.

Choose a template for rich text, chart, or fields list elements and create an Arcade expression that defines the element's content.

1. Follow the first four steps in the Configure pop-ups section to open the Pop-ups pane for the layer you want to configure.
2. Click Add content and choose Arcade.

   The editor window appears.

3. Click Suggestions and choose a template from the Templates tab to create the expression.

   Tip:

   Arcade elements return a dictionary that defines your pop-up element. Templates help you get started with the correct dictionary structure. Learn more about the structure of pop-up elements and the pop-up element profile in Arcade.
4. In the editor, click Done when you're finished.

   Tip:

   Before closing the editor, give the Arcade element a title that makes it easily identifiable in the list of pop-up content elements.
5. On the Contents (dark) toolbar, click Save and open and click Save to save the pop-up changes to the map.

Show related records

Some layers you add to Map Viewer may contain preestablished relationships to other tables or layers through a common field. For example, a layer showing buildings may have a preestablished relationship to a table with information about each building's tenants. If your layers have relationships, you can configure pop-ups to display the related records.

You can create data relationships within geodatabases in ArcGIS Pro and publish the data to ArcGIS Online or ArcGIS Server (version 10.1 or later is required). Some of the analysis tools, such as Summarize Within, create relationships for you if you choose a field to group statistics. You cannot create relationships in Map Viewer pop-ups.

Map Viewer supports one-to-one and one-to-many relationships. To show related records in a pop-up, the tables or layers that contain the related data must be added to the map.

Note:

It is recommended that you configure pop-ups for both layers involved in the relationship.

To show related records in a pop-up, do the following:

1. Follow the first four steps in the Configure pop-ups section to open the Pop-ups pane for the layer you want to configure.
2. Click Add content and choose Related records.
3. Enter a title for the related records shown in the pop-up.
   1. Click Add field to select a field or expression from the data.
   2. Optionally, enter static text instead of or in addition to the field value.
   3. Leave the field blank if you don't want a title.
4. Enter a description for the related records.
   1. Click Add field and select a field or expression from the data. Use this option if you want a unique description for each feature in the data.
   2. Optionally, enter static text instead of or in addition to the field values.
   3. Leave the field blank if you don't want a description.
5. Choose a relationship from the drop-down menu.

   The drop-down menu only shows relationships whose component layers have been added to the map.

6. From the Sort by drop-down menu, choose a field from the related table or layer.
7. From the Sort order drop-down menu, choose a sorting method for the related records.
8. From the Preview count drop-down menu, choose how many related records are shown in the pop-up.
9. On the Contents (dark) toolbar, click Save and open and click Save to save the pop-up changes to the map.

   Related records are now displayed in the pop-up when you or others click a feature on the map. To get information about a related record, click the arrow next to it in the pop-up. Alternatively, click Show all to view all related records for the selected feature.