Skip To Content

Configure pop-ups

A map can show descriptive information about features configured to display in a pop-up. Pop-ups bring to life the attributes associated with each feature layer in the map, such as hiking trails, land values, or unemployment rates. They can show attachments, images, and charts and can link to external web pages. You can configure pop-ups on imagery when you're working with a mosaic dataset-based image service. A pop-up on an image layer displays the attributes of images at its current location, such as the acquisition date, sensor type, and cloud cover.

The default pop-up appearance for a layer is a plain list of attributes and values. As a map owner, you can reconfigure the pop-ups to define the list of visible fields, hidden fields, and how to present that information. For example, you might show a list of attributes or provide a rich interactive experience for visualizing and comparing features in a particular layer by providing custom-formatted text and charts.

You can configure pop-ups in ArcGIS Server service layers, hosted feature layers, hosted tile layers, layers from files, and OGC WMS and WFS layers. If you are configuring pop-ups for an ArcGIS Server feature layer, you can also set which fields are editable. If your layers contain related data, you can configure pop-ups to show the related data within the pop-up or in a table. Pop-ups for OGC WMTS layers are not supported. Configuring pop-ups on KML layers is not supported; any feature data in the layer is automatically displayed (you cannot configure or disable them). Pop-up configurations you make on layers you own can be saved with the item properties and automatically enabled on other maps using that layer. The configuration applies to the layer in the map only and not the actual service running on your ArcGIS Server.

You need to share your ArcGIS Server service layer in the website for the pop-ups to appear in your maps. If you share your service with groups you belong to, and not with everyone (public), only group members will see your pop-ups.

Enable and remove pop-ups

A map can show descriptive information about features configured for display in a pop-up. Enabling pop-ups in a layer is quick. However, layers can contain a large amount of feature data, and maps can include several layers, so the pop-up tends to look better if you take the time to configure them with selected fields, formatting, media, and so on. Feature layers always have the pop-up enabled, so you do not see an option to enable pop-ups. You do see an option to configure them.

  1. Verify that you are signed in and have privileges to create content.
    Note:

    If you do not have privileges to create content, you can still enable pop-ups to explore data by clicking Modify Map.

  2. Open the map in the map viewer, click Details, and click Contents.
  3. Browse to the sublayer that contains the feature data you want to show in a pop-up, click More Options More Options, and click Enable Pop-up.

If you do not want to display pop-ups for a layer you have previously enabled, browse to the feature layer, click More Options More Options, and click Remove Pop-up. There is no option to remove pop-ups for map notes or KML layers.

Enable pop-ups on hosted tile layers without feature data

You can display pop-ups on hosted tile layers that don't have any attribute data by specifying a feature layer with the data you want to show.

  1. Open the map in the map viewer, click Details, and click Contents.
  2. Browse to the sublayer of the hosted tile layer where you want to display attribute data, click More Options More Options, and click Enable Pop-up.
  3. Specify how you want to choose a layer—Choose from my items or Enter a URL for a layer.
    • If you selected to choose from your items, check the box if you want to include items from your organization, select a map or feature layer from the list, and select a sublayer in the layer to use in the pop-up.
    • If you selected to enter a URL, enter a URL, for example, https://<Server>/ArcGIS/rest/services/<Service>/<LayerId> and select a sublayer in the layer to use in the pop-up.
  4. Click Enable Pop-up.
Tip:

You can follow these same steps for displaying pop-ups on cached map image layers that don't have any attribute data.

Configure pop-ups

  1. Verify that you are signed in and, if you want to save your pop-up changes, have privileges to create content.
    Note:

    If you do not have privileges to create content, you can still configure pop-ups to explore data by clicking Modify Map.

  2. Open the map in the map viewer, click Details, and click Contents.
  3. Browse to the sublayer that contains the feature data you want to configure in a pop-up, click More Options More Options, and click Configure Pop-up.
  4. Enter a title for your pop-up.
    1. Use the [+] button to select field values from your data. The field values contain field aliases followed by the field names. By default, the primary field is displayed.
    2. Optionally enter static text instead of or in addition to your field values.

    Suppose you want your title to show population by county. You could configure your title with a combination of static text and field values, such as typing Population for, inserting your data's field value of county names [Cnty_name], typing the equals sign = and, finally, inserting another field value that shows population, [pop2010]. You would configure your title to be the following:

    Population for [Cnty_name] = [pop2010]

    This gives you a title where the field values are substituted into the title, for example, Population for Clark County = 453099.

  5. Select an attribute option from the drop-down menu to set the contents for the pop-up. Your choices are a list of field attributes, a description from one field, a custom attribute display, or no attribute information. If your layer contains related fields, you can configure the pop-up to show related records in a table.
    1. To configure the attributes within the field or fields you want to display, click the Configure Attributes link. Select which fields you want to display. You can also select a field to change its alias, order it, and format it. For number fields (such as population), select the number of decimal places to display and whether to use a 1,000 separator.
      Tip:

      If the layer supports editing, you can select which fields to edit. Be sure to also display the field (so it appears in the edit pop-up). For editable text fields, you can select the type of text box and provide a hint.

      For date fields that include time, select a format that includes both. By default, only dates are displayed.

    2. If you selected to show a description from one field, click the arrow under Select the field containing the description and click a field name to display.
    3. If you've selected a custom attribute display, click Configure to define and format the information you want to show. The custom attribute display allows you to use a combination of rich text, attributes, links, and supported HTML to give you the most control and flexibility over your display. If you create a custom attribute display for an editable layer, the attributes appear as a list when someone edits the feature.
  6. If your feature layer includes attachments, you can select to show attachments as links at the bottom of the pop-up. Attachments are supported as a related table to a feature class in a feature service.
  7. Add media to your pop-up if you want, such as images or charts.
  8. Click OK when you are finished configuring your pop-ups.
  9. Click Save Layer to save the configuration as a property of the item. You can only save item properties if you own the layer or if you save it as a new item.
  10. Click Save from the top of the map viewer to save the pop-up changes to the map.

Show attachments

Pop-ups can be configured to show attachments as links if the map includes a feature layer that has attachments in its data. You will only see an option to show attachments if the layer has them. When the pop-up is displayed, the attachment links are listed at the bottom of the window. Clicking one of the links opens the attachment in a new window.

  1. Follow the first six steps in the Configure pop-up section to open the Configure Pop-Up pane for the layer you want to configure.
  2. Check the box next to Show feature attachments as links.
  3. Click OK.
  4. Click Save Layer to save the configuration as a property of the item. You can only save item properties if you own the layer or if you save it as a new item.
  5. Click Save from the top of the map viewer to save the pop-up changes to the map.

Show images

You can include images in your pop-ups by entering a URL to an image. The images can include titles, captions, and links to related websites.

Tip:

For the best display, you should create images that are 200 pixels wide and 150 pixels high. If your image is smaller than 200 by 150, you will see a white border in the window. If the image is larger, your web browser automatically rescales the image to 200 by 150 and it may appear warped.

  1. Follow the first six steps in the Configure pop-up section to open the Configure Pop-Up pane for the layer you want to configure.
  2. Click Add and choose Image.
  3. Enter a title for the image. By default, the primary field is displayed.
    1. Click [+] and select a field value from your data. Use this option if you want a unique title for each feature in your data.
    2. Optionally enter static text instead of or in addition to your field value.
    3. If you don't want a title with your image, delete any text that appears in the field so the field is blank.
  4. Enter a caption. The caption appears below the title and above the image. It is useful for giving a short explanation of the image. By default, no caption is displayed.
    1. Click [+] and select a field value from your data. Use this option if you want a unique caption for each feature in your data.
    2. Optionally enter static text instead of or in addition to your field values.
    3. If you don't want a caption with your image, delete any text that appears in the field so the field is blank.
  5. Enter the URL to the image.
    1. Click [+] and select a field value from your data. Use this option if you want a unique image for each feature in your data.
    2. Optionally enter the URL to an image stored on an external website, on ArcGIS Online, or as an attachment within the layer's data. PNG, JPEG, and GIF images are supported.
  6. Enter the URL of a related link. When the image is clicked, this URL will open in a new window. It is optional.
    1. Click [+] and select a field value from your data. Use this option if you want a unique URL for each feature in your data.
    2. Optionally enter the URL of a related link.
  7. Click OK to save your image configuration and close the Configure Image window.
  8. If you have more than one image (or other media items) and want to change the order of how the items appear in the pop-up, click a media item in the Pop-up media box and click Up or Down.
  9. Click OK.
  10. Click Save Layer to save the configuration as a property of the item. You can only save item properties if you own the layer or if you save it as a new item.
  11. Click Save from the top of the map viewer to save the pop-up changes to the map.

Show charts

You can add charts to graphically display the values of numeric attribute fields. You can add pie charts, bar charts, column charts, and line charts. If your layer contains related fields, you can configure the chart to show related records in a table.

  1. Follow the first six steps in the Configure pop-up section to open the Configure Pop-Up pane for the layer you want to configure.
  2. Click Add and choose the type of chart you want to show.
  3. Enter a title for the chart.
    1. Use [+] to select a field value from your data. By default, the primary field is displayed.
    2. Optionally enter static text instead of or in addition to your field value.
    3. If you don't want a title with your chart, delete any text that appears in the field so the field is blank.
  4. 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 may wish to include an indication of units for column, bar, or line charts in the chart description. A pie chart shows percentages, and this will be labeled on the chart when the pop-up is maximized.
    1. Use [+] to select a field value from your data. By default, no caption is displayed.
    2. Optionally enter static text instead of or in addition to your field value.
    3. If you don't want a caption with your image, delete any text that appears in the field so the field is blank.
  5. Select which fields to include in the chart.
  6. Select a Normalization field to normalize the data. The values in this field will be 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.
  7. Click OK to save your image configuration.
  8. If you have more than one chart (or images) and want to change the order of how the items appear in the pop-up, select a media item and click Up or Down.
  9. Click OK.
  10. Click Save Layer to save the configuration as a property of the item. You can only save item properties if you own the layer or if you save it as a new item.
  11. Click Save from the top of the map viewer to save the pop-up changes to the map.

Show related data

A layer in your map may contain a preestablished relationship to another table through a common field. For example, if you have a layer of buildings, it may have a preestablished relationship to a layer that shows information about the tenants that occupy that building. If there is a relationship, the pop-ups include a link to show related records in a table. In addition, you can configure pop-ups to display related data within the pop-ups.

You can create data relationships within geodatabases in ArcGIS Desktop 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, will create relationships for you if you choose a field to group statistics. You cannot create relationships in the map viewer except with these analysis tools. The map viewer supports one-to-one and one-to-many relationships. To show related records in a table, the layers that contain the related data must be in the map.

Follow the steps below to configure pop-ups to display related data.

  1. Follow the first six steps in the Configure pop-up section.
    • Within Configure Attributes, choose the related fields you want to display. Related fields include {relationships} in the field name.
    • With a one-to-one relationship, the pop-up displays the related attributes within the pop-up window.
    • With a one-to-many relationship, choose to display the related data within the pop-up window or in a table. When displaying attributes within the pop-up, string fields show the count. For numeric fields, you can choose to display the sum, min, max, average, or count.
    • For numeric fields, select the number of decimal places to display and whether to use a 1,000 separator.
  2. To show a chart, follow the steps in the Show chart section.
    • For layers that have a one-to-one relationship, you can create a chart from attributes in the layer.
    • If the layer has a one-to-many relationship, choose to create the chart from attributes in the layer or a related layer or table.
    • If you chose to create a chart from a related layer or table, choose the related layer or table, a chart field, and a label field.
  3. If you want to disable the link to show related records in a table, uncheck the box next to Show related data.
  4. Click OK.
  5. Click Save Layer to save the configuration as a property of the item. You can only save item properties if you own the layer or if you save it as a new item.
  6. Click Save from the top of the map viewer to save the pop-up changes to the map.

Configure pop-ups for imagery

You can configure pop-ups on an image layer when you're working with a mosaic dataset-based image service. A pop-up on an image layer displays the attributes of images at its current location, such as the acquisition date, sensor type, and cloud cover. The pop-up will display information only from the images that are visible at the current map scale. Images are ordered in the pop-up based on the display order setting. To learn more about map scale and image display ordering, see Display imagery.

Pop-ups can also display the pixel values of quantitative data, which may represent elevation, precipitation, temperature, reflectance, and other such information. There are two types of quantitative pixel values that you can configure: Item Pixel Value and Service Pixel Value. Item pixel value represents the raw pixel value at a given location. Service pixel value represents the mosaicked, processed, and resampled pixel value at the current map scale. You have three options for displaying Service Pixel Values:

  • Service Pixel Value (current display): shows the pixel value of whichever processing template or renderer is currently selected.
  • Service Pixel Value (none): displays the mosaicked pixel value without any additional processing applied.
  • You can also select any or all of the processing templates that are associated with the image service. Select the processing templates that you want to include in the pop-up.

For example, a Landsat service may have Normalized Difference Vegetation Index (NDVI) applied at the service level. In this scenario, the service pixel values represent NDVI, whereas the item pixel values represent the raw digital number (DN) values. For an image service published using ArcGIS Server 10.4 and later, you can configure multiple Service Pixel Values derived from a set of different processing templates. You can set up your image layer to display elevation data using a hillshade template, and configure the pop-up to show Item Pixel Values (elevation) and Service Pixel Values from Slope and Aspect templates.

When working with qualitative data, you can display categorical information associated with the pixel values—such as land-cover type—as well.

Note:

If you are working with an image service created from a raster dataset, as opposed to a mosaic dataset, you can also configure pop-ups; however, they will only display the service pixel value.

To show pixel values and categorical information in pop-ups, follow the steps below.

  1. Follow the first six steps in the Configure pop-up section to open the Configure Pop-Up pane for the imagery layer you want to configure.
  2. Click Configure Attributes to open the Configure Attributes window.
  3. Scroll to the Service Pixel Value and Item Pixel Value field names.

    If your image service includes categorical information, you will see fields that start with Raster. You can configure the settings to display these fields as well.

  4. Check the box next to Item Pixel Value if you plan to display the raw values of your data. You can rename a field using a field alias to describe your data better.
  5. Check the box next to Service Pixel Value if you plan to display the processed values of your data. You can rename a field using a field alias to describe your data better.
  6. Click OK to accept the attribute fields to display in your pop-up.
  7. Click Save Layer to save the configuration as a property of the item. You can only save item properties if you own the layer or if you save it as a new item.
  8. Click Save from the top of the map viewer to save the pop-up changes to the map.