Skip to main content

Home control

The Home control adds a single button that returns the view to the WebMap's initial extent.

What it does

Renders the native arcgis-home button. Clicking it animates the view back to the extent the WebMap was authored with—the same extent the map uses the first time it settles on load.

Configuration

FieldTypeDefaultPurpose
controls.homeControlPlacement | nullnullCorner placement, or null to hide.

In the config panel

Open Appearance → UI controls and drag the Home chip onto a corner (or into a corner's expand). Drag it back to the tray to hide it.

Behavior

  • Navigates to the WebMap's initial extent, not a per-widget viewpoint, so it always matches what authors set on the item.
  • Returning home re-fires map:extent-change, so any extent-wired filters update to the home extent.