Skip To Content

Use URL parameters

In this topic

Apps created with Web AppBuilder can be modified directly with URL parameters. The URL always begins with <your portal url>/apps/webappviewer/index.html? and includes one or more of the parameters listed below. To include more than one parameter, use an ampersand (&) to separate the parameters. For example:

http://<your portal url>/apps/webappviewer/index.html?id=6815e148ff1c4aee8dc7159816380a4d&webmap=9cf053ea602345ddae060010c470e615
Caution:

The url parameter for projection only supports WKID 3857 and 4326. This is a known issue and will be addressed in the next release.

Open saved app

To open a saved app created with Web AppBuilder, use id= and the unique ID of the app. For example:

http://<your portal url>/apps/webappviewer/index.html?id=6815e148ff1c4aee8dc7159816380a4d

Define web map

To define the web map, use webmap= and the unique ID of the web map. For example:

http://<your portal url>/apps/webappviewer/index.html?webmap=9cf053ea602345ddae060010c470e615

Center map

To center the map at a particular location, set center= using geographic coordinates (x,y) or projected coordinates (x,y,WKID). You can use commas or semicolons as separators. Use semicolons if your numbers use colons as their decimals.

Geographic coordinates example

http://<your portal url>/apps/webappviewer/index.html?center=34,-50

Projected coordinates example

http://<your portal url>/apps/webappviewer/index.html?center=500000,5500000,102100

Define scale level

To define the scale level of the map, use the center= and level= parameters. The level parameter accepts the level ID of the cache scale as listed in the map service's REST endpoint. For example:

http://<your portal url>/apps/webappviewer/index.html?center=20,45&level=4

Define scale

To define the scale of the map, use the center= and scale= parameters. The scale parameter accepts the cache scale as listed in the map service's REST endpoint. For example:

http://<your portal url>/apps/webappviewer/index.html?center=20,45&scale=4622324

Define extent

To define the extent of the map, use extent= to define the extent of the map. The extent parameter accepts geographic coordinates (GCS) as MinX,MinY,MaxX,MaxY or projected coordinates (PCS) as MinX,MinY,MaxX,MaxY,WKID. You can use commas or semicolons as separators. Use semicolons if your numbers use colons as their decimals.

Geographic coordinates example

http://<your portal url>/apps/webappviewer/index.html?extent=-117.20,34.055,-117.19,34.06

Projected coordinates example

http://<your portal url>/apps/webappviewer/index.html?extent=-13079253.954115,3959110.38566837,-12918205.318785,4086639.70193162,102113