Skip To Content
ArcGIS Developer

Visibility widget

(Added at version 2.11)

The Visibility widget determines what is visible from an observer location based on a given distance, an observer height, and a field of view.


If you include this widget in your app, confirm that your end users have the required privileges described in the Use this widget section.

Configure the Visibility widget

This widget can be set to open automatically when an app starts. Hover over the widget and click the Do not open this widget when the app starts button Do not open this widget when the app starts to change the setting to Open this widget automatically when the app starts. (For widgets that you need to add to the app first, you can turn on this option after configuring the widget.)

  1. Hover over the widget and click the Configure this widget button Configure this widget to open the configuration window.

    If you need to add the widget to the app first, click a widget placeholder on the Widget tab. In the Choose Widget window that opens, select the widget and click OK.

  2. Optionally click Change widget icon to replace the default icon for this widget.

    A file explorer window appears, allowing you to upload a local image file to use as the widget icon.

  3. In the URL text box, specify the URL to your organization to allow the tool to consume an elevation service.

    If you are using ArcGIS Enterprise, you must configure a default elevation service.

  4. Optionally change the default values and units for the following observer settings:
    • Set mils for angles as default (default unit is degrees)
    • Default Observer Height
    • Default Observer Height unit (default unit is meters)
    • Default Minimum Observable Distance
    • Default Maximum Observable Distance
    • Default Observable Distance unit (default unit is kilometers)
  5. For Select an operational layer for results, choose from a list of polygon feature layers in the current web map to which users can save results.

    The list only includes layers from your organization. If the map uses polygon feature layers from another organization, they do not appear in the list.

  6. Click Set.
  7. Click OK to close the Configure Visibility dialog box.

Use the Visibility widget

Learn how to conduct a Radial Line of Sight (RLOS) analysis with the widget.


The Visibility widget uses the CreateViewshed module and requires at least publisher privileges. Using the tool consumes credits.

Create an RLOS analysis with the Visibility widget

You can conduct an RLOS analysis from a user-defined point and visibility parameters.

  1. Set the observer location by providing coordinates in the Observer Location text box and pressing Enter, or click the Add Observer Location button Add Observatory Location to interactively select a point.
  2. Optionally click the Format Input button Format Input to open the Set Coordinate Format String dialog box.
  3. Optionally double-click the number in the center of the Field of View ring to type an angle to specify the width of the field of view.

    A segment of the ring corresponding to that angle will turn green to indicate the observer's field of view, and the remainder of the ring will turn red. If you do not set an angle, the widget will use a full 360-degree field of view.

  4. Click and drag the green segment of the Field of View control to specify the bearing of the center of the observer's field of view.

    The bearing angle will be displayed as you drag the field of view.

  5. Angle measurements are in degrees by default. Optionally click the toggle button to the right position to use mils for angles and type a new value in mils for the Field of View.
  6. Enter a value for Observer Height and use the drop-down menu to set the units of measurement.
  7. Enter a value for Min Observable Distance and use the drop-down menu to set the units of measurement.
  8. Enter a value for Max Observable Distance.
  9. Click Create.
  10. Optionally click Clear to clear the results.