Back to Top

Configure pop-ups

In this topic

  1. Customize pop-up elements
  2. Use related data
  3. Hyperlinks

When configuring pop-ups for your feature layers, you can customize the content as well as how the content is displayed. Pop-ups can contain custom text and a list of fields, charts, images, and attachments.

To configure a pop-up for a layer, right-click the layer in the Contents pane and click Configure Pop-ups Configure Pop-ups. This opens the Configure Pop-ups pane, where you can define the content for the selected layer.

Customize pop-up elements

You can add elements to the pop-up definition by clicking the element type at the top of the pane. Pop-up elements support related data, hyperlinks, and Arcade expressions.

The following table lists the pop-up elements along with a description of each:

ElementDescription

Title

Text or field values that provide the name for the pop-up. Use the Field drop-down to add dynamic text from the layer itself.

Text Text

Add custom text to the pop-up, including hyperlinks.

List of Fields Fields

Choose the fields to display in the pop-up. If the layer has related records, statistics of the related numeric fields can also be included.

Chart Chart

Build vertical or horizontal bar charts, line graphs, or pie charts. You can only use numeric fields for both the chart and for the field used to normalize the chart.

Charts can have a title and a caption.

Image Image

Provide an image from a URL or attachment and set a custom title or caption. For attachments, you have access to the name of the file from the Field drop-down menu so you can distinguish a title or caption for multiple attachments. Images sourced from an attachment are dropped in the web map or feature layer.

Attachments

For layers with enabled attachments, you can display the list of attachments within the pop-up. In the Configure Pop-ups pane, check the Show list of Attachments option at the bottom. Once enabled, the pop-up will list hyperlinks that launch each attachment in the default file handler. If you display a pop-up for a feature that does not have an associated attachment when the Show list of attachments option has been checked, a message will appear in the pop-up indicating that no attachments were found.

After you select an element, double-click it to edit its properties or click the Edit pop-up element button Edit Pop-up Element.

After you edit the properties of an element, click Back Back to return to the home page in the Configure Pop-ups pane to commit your changes. Changing the selected layer in the Contents pane will also commit your changes. The next time you interact with pop-ups, the updates will be reflected.

Tip:

At the bottom of the Configure Pop-ups pane, you can disable pop-ups, customize them with ArcGIS Arcade expressions, and reset them to their previous state.

Use related data

When a layer participates in a relate or relationship class, the related data can be accessed in the pop-up's upper portion where it lists the identified items. You can also use the Configure Pop-ups pane to add fields or statistical functions to the pop-up's lower section, based on the related data. For text elements in the pop-up, you can choose a field from a related table from the Fields drop-down menu. For the fields element, the related data is appended below the main list of fields. For chart elements, you can choose from the related table's numeric fields to add to your chart. Numeric field formatting for decimal places is honored by the pop-up.

Relationship classes must have a cardinality of 1:1, 1:M, or M:N to be used in a pop-up.

For 1:1 relationships, values from the related table are copied from the singular related record. For example, for a 1:1 relate between a layer named Offices and a table named Current Staff, the pop-up can display the office identifier from the first table, and the current occupant's name and hire date from the second table.

For 1:M and M:N relationships, statistical summary values are collated from the potentially multiple related records. For example, for a 1:M relate between a Land Records layer and a Previous Owners table, the pop-up can display the parcel address from the first table and the count of previous owners and maximum purchase price from the second table.

Related records statistics

If a layer has related records, statistics for the related numeric fields can also be included in the pop-up using the following steps:

  1. Right-click the layer in the Contents pane and click Configure Pop-ups Configure Pop-ups.
  2. Click the Edit pop-up element button Edit Pop-up Element for the Fields element.
  3. Under the Related Records: Statistics heading, expand the arrow next to the related table name from which you want to include statistics. All numeric fields from that table will be listed.
  4. Check the Display box next to the desired fields. A new row containing the applicable statistics will appear beneath the chosen field name.
  5. Choose the related statistics you want to add to the pop-up.
  6. Click Back Back to exit Fields Options and commit your changes. You will return to the main page on the Configure Pop-ups pane.

    If no related statistic was chosen at step 5, the related field will be automatically unchecked when you commit your changes.

Hyperlinks

Hyperlinks can be applied to image, chart, and text elements to add additional information to pop-ups. You can then click the linked element in the pop-up window to open a web page, document, or other information.

Insert hyperlinks as text elements

  1. In the Contents pane, right-click the layer with the pop-up and click Configure Pop-ups Configure Pop-ups.
  2. In the Configure Pop-ups pane, click the Text element button Text to add it to the pop-up.
  3. Click the Edit button Edit Pop-up Element to edit the text element.
  4. Place the pointer at the desired link location and click the Hyperlink button Hyperlink from the list of buttons at the top of the page.
  5. For URL, provide a URL or path to the item you want to open or display when you click the image, chart, or text in the pop-up window. Do one of the following:
    • Provide a full path to the desired item, for example, \\machineName\sharedDirectory\imageName.jpg or file:///C:\Users\temp\OperationsSchedule.docx.
    • Provide a base path and get the remaining portion of the path from an attribute table field, for example, \\machineName\sharedDirectory\{Hyperlink_FieldName}. You can also use "mailto:"{EmailAddressField}.
    • Have the source URL in an attribute table field and reference the field as {FieldNameWithLinks}.
    • Use an Arcade expression that can be referenced by name as {expression/expression0}.
  6. For Description, provide the text you want displayed as a link and click Apply.
  7. Optionally specify and format additional text.
  8. To save your edits, click the Back button Back on the Text Options tab in the Configure Pop-ups pane.

Insert hyperlinks as chart elements

  1. In the Contents pane, right-click the layer with the pop-up and click Configure Pop-ups Configure Pop-ups.
  2. In the Configure Pop-ups pane, click the Chart element button Chart to add it to the pop-up.
  3. Click the Edit button Edit Pop-up Element to edit the chart element.
  4. Chart elements accept hyperlinks in the Title and Caption sections. Place the pointer at the desired location and click the Hyperlink button Hyperlink from the list of buttons at the top of the page.
  5. For URL, provide a URL or path to the item you want to open or display when you click the image, chart, or text in the pop-up window. Do one of the following:
    • Provide a full path to the desired item, for example, \\machineName\sharedDirectory\imageName.jpg or file:///C:\Users\temp\OperationsSchedule.docx.
    • Provide a base path and get the remaining portion of the path from an attribute table field, for example, \\machineName\sharedDirectory\{Hyperlink_FieldName}. You can also use "mailto:"{EmailAddressField}.
    • Have the source URL in an attribute table field and reference the field as {FieldNameWithLinks}.
    • Use an Arcade expression that can be referenced by name as {expression/expression0}.
  6. For Description, provide the text you want displayed as a link and click Apply.
  7. Optionally specify and format additional text in the Title and Caption sections.
  8. To save your edits, click the Back Back button on the Chart Options tab in the Configure Pop-ups pane.

Insert hyperlinks as image elements

  1. In the Contents pane, right-click the layer with the pop-up and click Configure Pop-ups Configure Pop-ups.
  2. In the Configure Pop-ups pane, click the Image element button Image to add it to the pop-up.
  3. Click the Edit button Edit Pop-up Element to edit the image element.
  4. Place the pointer at the desired link location—image elements accept hyperlinks in the Title and Caption sections—and click the Hyperlink button Hyperlink from the list of buttons at the top of the page.
  5. For URL, provide a URL or path to the item you want to open or display when you click the image, chart, or text in the pop-up window. Do one of the following:
    • Provide a full path to the image, for example, \\machineName\sharedDirectory\imageName.jpg or file:///C:\Users\temp\OperationsSchedule.docx.
    • Provide a base path and get the remaining portion of the path from an attribute table field, for example, \\machineName\sharedDirectory\{Hyperlink_FieldName}. You can also use "mailto:"{EmailAddressField}.
    • Have the source URL in an attribute table field and reference the field as {FieldNameWithLinks}.
    • Use an Arcade expression that can be referenced by name as {expression/expression0}.
  6. For Description, provide the text you want displayed as a link and click Apply.
  7. For Source URL, provide a URL or path to the image you want displayed in the pop-up window.
  8. For Hyperlink, provide a URL or path to the item you want displayed upon executing the link.
  9. To save your edits, click the Back button Back on the Image Options tab in the Configure Pop-ups pane.

Feedback on this topic?

In this topic
  1. Customize pop-up elements
  2. Use related data
  3. Hyperlinks