Skip to main content

Editor control

The Editor adds the ArcGIS out-of-the-box editing experience—create, update geometry/attributes, delete, and attachments—for the WebMap's editable feature layers.

What it does

Renders the native arcgis-editor panel. Capability toggles set the panel-wide behavior, and per-layer overrides let you restrict individual layers further (including which fields appear in the edit form).

When it appears

The editor is gated at render time. It only appears when both are true:

  • a user is signed in, and
  • the loaded map has at least one editable feature layer.

A layer counts as editable when its service reports an editing operation (supportsAdd, supportsUpdate, or supportsDelete) and editing is not disabled on the layer. Editable layers nested inside group layers (at any depth) are found by walking the layer tree. Group layers are containers, not editable layers, so they are never offered as override targets. The control never appears on read-only maps.

Configuration

FieldTypeDefaultPurpose
editor.placementControlPlacement | nullnullCorner placement, or null to hide.
editor.allowCreatebooleantrueAllow creating new features.
editor.allowUpdateGeometrybooleantrueAllow moving / reshaping features.
editor.allowUpdateAttributesbooleantrueAllow editing attributes.
editor.allowDeletebooleantrueAllow deleting features.
editor.allowAttachmentsbooleantrueAllow working with attachments.
editor.snappingbooleantrueShow the snapping controls.
editor.popupEditActionbooleantrueAdd an Edit action to feature popups.
editor.layersEditorLayerOverride[] (max 20)[]Per-layer overrides.

Per-layer overrides

Each EditorLayerOverride is { layerId, enabled, addEnabled, updateEnabled, deleteEnabled, fields }:

  • enabled — master switch; when off the layer is not editable.
  • addEnabled / updateEnabled / deleteEnabled — restrict (never expand) the layer's create / update / delete capabilities relative to the global toggles.
  • fields — names of the fields to show in the layer's edit form. Empty means show every field (the layer's default form); listing fields restricts the form to just those, surfacing only the attributes that should be edited.

A layer with no override inherits the global capability toggles.

In the config panel

  1. Open Appearance → UI controls and drag the Editor chip onto a corner (or into a corner's expand).
  2. Once placed, set the Editing capabilities toggles (create, move/reshape, attributes, delete, attachments, snapping, and Add Edit button to popups).
  3. Under Per-layer overrides, add a layer to give it its own rules. Each row has an Editable master toggle plus Create / Update / Delete checkboxes, and a Choose which fields to edit picker.
  4. In the field picker, use Select all / Deselect all to toggle every field at once, or tick individual fields. Leaving the picker off shows every field.

Behavior

  • Popup edit action. When Add Edit button to popups is on, editable layers' feature popups gain an Edit action that launches the editor's update workflow for the clicked feature.
  • Content-driven height. The editor panel sizes to its content (capped by a max height), so a form limited to a single field no longer stretches to fill the map.
  • Cancel on collapse. When the editor sits inside an expand, collapsing the expand cancels any active edit workflow so the feature is released and a different one can be selected.
  • Source changes. Per-layer overrides reference operational layer ids, so they are cleared when the WebMap source changes.