Frequently asked questions


Use the application


What is ArcGIS Excalibur?

ArcGIS Excalibur is a web-based imagery application that modernizes and enhances image-based workflows through intuitive experiences. These experiences enable you to search for, discover, and work with imagery in fully integrated workflows for image analytics.

For more information, see What is ArcGIS Excalibur.

What is required before installing ArcGIS Excalibur?

Prior to installing Prior to installing ArcGIS Excalibur, you need an ArcGIS Enterprise base deployment with ArcGIS Image Server authorized with ArcGIS Server. You can install the base deployment on one or more machines, any of which can be physical, virtual, or cloud machines.

Different versions of ArcGIS Excalibur work with different ArcGIS Enterprise versions. The compatibility is as follows:

  • V2.4 - 11.0, 10.9.1, 10.9
  • V2.3—10.9.1, 10.9, 10.8.1
  • V2.2—10.9, 10.8.1, 10.8
  • V2.0-2.1—10.8.1, 10.8, 10.7.1
  • V1.2—10.8, 10.7.1, 10.7
  • V1.1—1.1.1 - 10.7.1, 10.7
  • V1.0—10.7

For more information on hardware and software requirements, see ArcGIS Excalibur system requirements.

How do I install and authorize ArcGIS Excalibur?

Download ArcGIS Excalibur from My Esri by logging in with your Esri account that is associated with your customer number. ArcGIS Excalibur should be installed on the machine where Portal for ArcGIS is installed.

Once ArcGIS Excalibur is installed, an authorization file must be obtained and authorized.

For more information on installing and authorizing, see Install and authorize ArcGIS Excalibur.

How is ArcGIS Excalibur licensed?

ArcGIS Excalibur is a premium application and requires a separate portal license file. You must have a Creator or GIS Professional user type with the appropriate roles before an ArcGIS Excalibur license can be assigned to you.

For more information, see System requirements or Assign members an ArcGIS Excalibur license.

Is ArcGIS Excalibur available in ArcGIS Online?

No. ArcGIS Excalibur is not available in ArcGIS Online and is only available in ArcGIS Enterprise 10.7 and later.

Can I customize ArcGIS Excalibur using an API?

No. ArcGIS Excalibur does not support customization using an API.

Is ArcGIS Excalibur designed for a specific persona?

No. Anyone who wants to discover, analyze, report, and efficiently disseminate image-derived information to consumers can use ArcGIS Excalibur. Users include all-source analysts, imagery analysts, and imagery and geospatial managers in industries such as national security, emergency response, local and federal government, humanitarian relief, and public works.

How can I use the Publish Imagery capability in ArcGIS Excalibur?

You must have your environment properly configured and the proper privileges to publish hosted web layers. If you have the proper environment and privileges, you can begin publishing hosted web layers by accessing it through the home page or at any time on the side navigation menu under Publish Layer. For more information, see Publish hosted web layers.

Use the application

Where can I obtain a web service URL?

You can obtain a web service URL through any of the following:

  • The Content tab of your Enterprise portal—You can search My Content or My Organization's Content for the layer type imagery layer.
  • ArcGIS REST Services directory (for example, https://<>/<webadaptor>/rest/services)—Many services defined as an ArcGIS Image Server Service denoted by (ImageServer) can be a supported service.
  • Your organization's GIS administrator.

For more information on using imagery web service URLs, see Explore a web service.

Why are there no images returning when I search in the Search and Discover page?

Ensure that your Search Settings filters and map extent is set to properties and a location where imagery exists for the selected imagery service layer.

To populate the Search and Discover page with imagery, please try browsing for imagery .

Why doesn’t my image support rendering in image focus view?

Image focus view is available on images that have sensor transformation information, such as rational polynomial coefficients (RPC) or frame cameras. Not all web services contain imagery with this sensor information.

For more information on the image focus view, see Explore a web service.

Why don't images show up in the image layer footprints?

Images may not display in the Search and Discover page when Toggle Image is enabled or in the Canvas in the Map Focus Panel due to a visibility scale range set on the image service. Try zooming in closer on the image footprint to get the image or set of images to appear.

Why do some imagery service layers have more measurement options?

The Measurement Tool dynamically reads in the metadata and capabilities set on the image service. The measurement options available will depend on the imagery service layer you are working with.

Why don't I see project tools in my Tools panel?

Project tools are only available when you open an Excalibur project in the canvas. The Collect Observations and Edit Observations tool is only available when you open an Excalibur project.

For more information on creating an Excalibur project, see Create an Excalibur project.

Does an observation layer require a specific schema?

No. Any editable layer can be used as an observation layer within an Excalibur project. However, using an observation layer that contains the system managed Excalibur fields adds value to the observation collection workflow as certain fields will be autopopulated with metadata from the image that the observation is collected on.

For more information on an observation layer, see Select observation layer.

How can I change the sharing setting on my Excalibur project?

Excalibur projects can be shared with your organization or can be left private during the guided workflow when creating an Excalibur project. At ArcGIS Excalibur 1.0-1.2, Excalibur projects are saved in a folder called Excalibur projects in My Content. Any Excalibur project created after version 1.2 will be created in a folder based on the name of the Excalibur project. You can change the share setting for your Excalibur projects in the portal.

Will my custom defined user settings still work if I access the application from a different machine?

Yes. User settings are stored and saved with your portal identity allowing you to access the ArcGIS Excalibur application on different machines in different locations while maintaining your customized experience.

Can I use content created in ArcGIS Excalibur in other ArcGIS applications?

Yes. ArcGIS Excalibur uses ArcGIS and its information model to consume and create content that can be applied to other ArcGIS applications. In particular, content created in an Excalibur project is written to a hosted feature service and can be used in other applications such as Map Viewer Classic and ArcGIS Pro and web applications such as ArcGIS Dashboards and ArcGIS Insights. You can also use exported views from the canvas in ArcGIS StoryMaps templates.

Does ArcGIS Excalibur support nonquery-enabled services?

Yes. You can view and work with imagery that is nonquery-enabled. Although these types of web services do not support search capabilities, you can still visualize this imagery in the canvas while using the many tools available to work with the web service.

Can I save my markup in the canvas?

Yes. You can save markup in the canvas as a project and refer to it later. To learn more about saving your markup in canvas, see Save markup to a project.

How do I add observation layers to my Excalibur project?

You can add or remove an existing observation layer or create a new observation layer through the project details. For more information about observation layers, see Add an observation layer to your Excalibur project.

Is there a limit on the number of search settings that can be applied when I save my query?

No. You can apply as many search settings as you like when you save your query. For more information, see Search by saved search query.

Do my observations need to be in the same layer when I use the Edit Observations tool?

Yes. Your observations need to be in the same layer to use the Edit Observations tool. For more information, see Edit Observations tool .

Why do I get an error when I use the Capture Coordinate tool in the Image Focus Panel?

Ensure that you are searching for your coordinate in your image extent. If you search for a coordinate outside your image extent, you get an error. For more information see, Capture a coordinate.

Why can't I add a GeoEnrichment definition to my Excalibur project?

To create a GeoEnrichment definition in your Excalibur project, the following criteria must be met:

  • You must be the project owner or the portal administrator.
  • You must have a point observation layer in your Excalibur project.
  • You must have a polygon context layer in a web map added to your project.

For more information, see Enhance an Excalibur project with GeoEnrichment definitions.

Am I allowed to add any layer to my Excalibur project and use it as an observation layer?

Yes, you can add any layer to your Excalibur project to use as an observation layer. You also have the option to add system-managed fields to populate information about the image when an observation is collected. For more information, see Manage system fields and settings.

Why is the Detect Change tool disabled even though I am in the canvas?

The Detect Change tool is disabled if the web service is not an ArcGIS Imagery Layer that is query enabled. A minimum of two selected images are required to run the tool. For more information, see Detect Change tool.

Why is the Download Source Imagery option unavailable when I try to export my image?

The Download Source Imagery option is only available if the image service has download capabilities enabled. For more information, see Export Image tool.

Does my Excalibur project definition file need to be formatted in a specific way before uploading it?

Yes, your JSON file must be properly formatted to successfully create an Excalibur project. You can find the format for projects with a single focus image layer and projects with observation layers in Upload an Excalibur project definition file.