Customize a dashboard using URL parameter

Learn how to create a data filter in ArcGIS Dashboards using URL parameters.

Esri regional offices dashboard with URL parameter filtering capabilities.

ArcGIS Dashboards provides several options for filtering data that you can use to display specific data in a dashboard. Here's an overview of how you can use ArcGIS Dashboards to create your own filter using URL parameters:

  1. Load a web map using the Dashboards map element.

  2. Create a category selector element to filter data.

  3. Set actions in the category selector element to sync with the map.

Prerequisites

Steps

This tutorial builds upon the Filtering data in a dashboard tutorial. If you have completed the tutorial and have a dashboard you can work with, you can skip to the Configure URL parameter section.

Create a dashboard

Now that you have a web map, you can create a dashboard to load it.

  1. In the Content tab of your organization, click Create app > Dashboards.

  2. In the Create new dashboard window, name the app Esri Regional Offices and add your desired tags.

  3. Click Create dashboard.

Load the web map

You can now load the web map into your dashboard.

  1. In the left-panel, click Add element > Map to add a map element to your dashboard.

  2. Click on Shared maps tab.

  3. In the Search bar, type the following: DS2023 - Regional Offices published by mtorrey_devlabs and select it.

  4. Click Done in the DS2023 - Regional Offices configuration window.

  5. In the left-panel, click Save > Save to save your work.

Create category selector

  1. In the left-panel, click View.

  2. Click Header > Done. This will give a title to your category selector window, which defaults to the dashboard title.

  3. Click Add selector > Category selector.

  4. In the Category selector settings window, click Features under the Categories from menu.

  5. Select the Esri Regional Offices US layer.

  6. In the left-panel, click on the Selector tab and set the following:

    • Enable Dropdown in Presentation mode

    • Enable Single in Selection

    • Enable Compact in Maximum height

  7. In the left-panel, click on the Actions tab and set the following:

    • Enable DS2023 - Regional Offices in Flash settings.

    • Enable DS2023 - Regional Offices in Show pop-up settings.

    • Enable DS2023 - Regional Offices in Pan settings.

    • Enable DS2023 - Regional Offices in Zoom settings.

  8. Click Done.

  9. In the left-panel, click Save > Save to save your work.

Configure URL parameter

You will configure a URL parameter that will allow users to query for an Esri regional office in the URL address of your dashboard.

  1. In the left-panel, click View.

  2. Click Settings tab. The Settings configuration window will then be displayed.

  3. In the URL parameters option, click Edit.

  4. Click Add URL parameter > Feature parameter.

  5. Change Name to office-name.

  6. Click Change and select the Esri Regional Offices US layer.

  7. Select Office Name in the Unique ID field.

  8. Click Done.

You can now query for an Esri regional office by adding #office-name=<value> to the end of the URL address of your dashboard. For example:

Use dark colors for code blocksCopy
1
https://arcgis-devlabs.maps.arcgis.com/apps/dashboards/92f63c5fb5494f5f835b4dd128199695#office-name=esri denver

Share the dashboard

  1. In the left-panel window, click the menu icon.

  2. Click Dashboard item details to view the item page of your dashboard.

  3. Click the Share button on the dashboard item page.

  4. Select the appropriate share level.

  5. Click Save.

Tutorials

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.