Linking to reports from an ArcGIS web map

Reports built with InstantAtlas Report Builder have a built in index page, whether you choose to use “live links” or to publish the reports to HTML. However, this is not the only way to link to reports. Every feature in your report has a unique URL – this post will walk you through how to use that URL to build links from your ArcGIS Online web maps directly to your reports.

The technical details of linking from a web map to a report using “live links” are covered in “Linking from a WebMap to a Report” in the Report Builder help pages. This post won’t repeat that information – instead it will step through this process using an example map and links to published reports, as used in websites powered by the InstantAtlas national data services.

The web map we are going to use is available at and is also embedded below:


Linking from a pop-up to a report relies on the ability to configure pop-ups in ArcGIS Online. This allows us to change the display from the (fairly boring) list of feature attributes to a rich HTML display with hyperlinks. To do this, we need to open the web map in the map viewer in ArcGIS Online, then click the menu item to configure the popup-up for the layer:

This opens a sidebar – in here you can edit the title of your popup but the interesting bit is the big green CONFIGURE button:

This brings up a dialog where you can type the text you want to show in your pop-up. You can bring in data from the fields of your layer using expressions like {<field-name>}, for example {NAME}. You can see where we have used this in the example popup-up below to show the name of the feature we have just clicked on:

The following reports are available for {NAME} ...

The next stage is to build links from the pop-up. Just type the text you want to use as a link, highlight it, then use the Create Link button. You can then edit the properties of that link:

The link URL is the important part – URLs used by reports always have the <report-id> and the <feature-id> in them. The <report-id> is the long value shown in the address bar when you view the report in ArcGIS Online, or when you view that report via your data observatory, e.g.

The <feature-id> comes from the fields of your layer – in our example each district has a unique ID stored in the LTLACode field. It makes up the final part of the URL:

Back to our example – for each feature the <report-id> stays the same, so in our link properties we just need to pass in the <feature-id>, using an expression:{LTLACode}

And that’s it! ArcGIS Online will do the rest of the work for us. Every time somebody clicks on a map feature (a district) the pop-up will be rebuilt with the data for that feature so all the links will take you directly to reports about that feature.

Once you have your web map with links, you can re-use that wherever and however you want – for example to make a web app that describes the map:

Related links:

Published by

Keith Morrison

ESRI UK - InstantAtlas