topic Re: District SearchWidget with Enterprise Locator two specific countries in ArcGIS JavaScript Maps SDK Questions

District SearchWidget with Enterprise Locator two specific countries

SebastianKrings — Thu, 19 Feb 2026 10:09:09 GMT

Hi,

currently we are using the SearchWidget with defaultSources enabled.
In our EnterprisePortal we have our own LocatorService.

As far as I understood the portal one is taken over arcgis.com-WorldLocator by simply setting the portalUrl in JS:

esriConfig.portalUrl = ...

Now we would like to district the search results to specific countries (DE + DK in my case).
I am not getting it to work.

Best guess I found is the LocatorSource to set the CountryCode.
https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-LocatorSearchSource.html
Unfortunately there is no sample.

I tried to place it into the sources-array which also countains our Layers to search in.
Additionally I disabled to use defaultSearchSource.

Here is my current code:

const sources = await this.getSearchSourcesAsync(handles); const sourceDE = new LocatorSearchSource(); sourceDE.countryCode = 'DE'; sources.push(sourceDE); const searchWidget = new Search({ view: mapView, includeDefaultSources: false, locationEnabled: false, sources, container: this.elementRefSearch!.nativeElement });

In the ExperienceBuilder its pretty easy to district on specific countries. It offers an option for that:

The LocatorSearchSource however only accepts a single country at once.

I hope there is an equivalent easy way to district the countries for the JS SearchWidget.

Re: District SearchWidget with Enterprise Locator two specific countries

WesleyO — Fri, 20 Feb 2026 20:49:24 GMT

Hi @SebastianKrings ,

Using the countryCode property is the correct equivalent you are looking for. You should be able to add multiple countries by separating them by commas for your string input, similar to how you have done it in Experience Builder.

Here is an example: https://codepen.io/woriginales/pen/KwMOZPP

Re: District SearchWidget with Enterprise Locator two specific countries

SebastianKrings — Mon, 23 Feb 2026 08:27:20 GMT

Hey thanks.

Is it somehow possible to omit url like using the default-sources where I do not need to put the geocode url?
I would prefer not to have const urls in my app.

Nevertheless, the documentation should be updated here as well.
For LocatorSearchSource for property countryCode it says:

Constricts search results to a specified country code. For example, US for United States or SE for Sweden.

https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-LocatorSearchSource.html#countryCode

Re: District SearchWidget with Enterprise Locator two specific countries

Noah-Sager — Wed, 25 Feb 2026 20:28:41 GMT

Unfortunately, if you modify the sources, you'll need the geocoding url as well. I think some devs put constants in a separate file if that helps.

The doc for countryCode looks right to me. Both "US" and "SE" seem to work fine. Can you explain what you think should be updated?

Re: District SearchWidget with Enterprise Locator two specific countries

SebastianKrings — Wed, 25 Feb 2026 22:50:06 GMT

The doc says no word about using multiple codes comma separated is a valid option.
For me it sounds that you just can enter exactly one code.
E.g.:
Instead of current:

Constricts search results to a specified country code. For example, US for United States or SE for Sweden.

It could be:

Constricts search results to one or more specified country codes. For example, US for United States or SE for Sweden or "'US', 'SE'" for both.

Re: District SearchWidget with Enterprise Locator two specific countries

Noah-Sager — Thu, 26 Feb 2026 15:52:18 GMT

Ah, that's a good call. Thanks for pointing that out @SebastianKrings, we'll improve the doc there.