Skip To Content

Branch Version Management widget

The Branch Version Management widget allows end users to manage the versions of branch versioned datasets. The widget provides the ability to switch versions, view and edit version information, and choose from different management capabilities such as create, assign, and delete versions. Changes made in this widget affect data across your app, so other widgets that use the same services display corresponding versions. If the widget is configured to allow creating new versions in a service, the new versions are also evident in the service when accessed in other apps, such as ArcGIS Pro.


Use this widget to support app design requirements such as the following:

  • You want to allow users to change the active version for layers in all the widgets that use the same layers in your app.
  • You want to allow users to create, modify, and delete versions in feature services that work with branch versioned datasets.

Usage notes

When you add a Branch Version Management widget, first select an arrangement style for the widget. This widget requires at least one data source (feature service or map service, registered as versioned). You can use this widget on a page with or without a displayed map. Currently, switched versions are only reflected in other widgets that are configured using the same feature service. If other widgets use a map service as the data source, they won't show the switched version.


If you add more than one Branch Version Management widget to your app, make sure that they don't point to the same service.

For each data source, you can choose which version to load on start. With the Advanced arrangement style, you can also specify the version information that's available and visible and which version management capabilities to allow in the widget.


It's recommended that you add this widget to a Widget Controller when using the Advanced arrangement style so users open the widget by clicking a button first.


The Branch Version Management widget includes the following settings:

  • Arrangement style—Choose how to display the widget and which version management capabilities to include.
    • Basic—Provide a simple version switcher that shows version name and owner and has no version management capabilities.
    • Advanced—Provide a version switcher with configured version information and version management capabilities.
  • Version management services—Select one or more data sources with versions to view and manage in the widget. The data source must be a feature service or map service that works with branch versioned datasets.

    Currently, the widget only supports services hosted in the same organization as the app you're configuring.

    If you add multiple services, use the arrows to reorder them. The service listed at the top will load on start. Configure version settings for each by selecting a service and setting the following options in the side panel that opens:
    • Select a version to load on start—Choose which version to load on start for the selected data source. If this version is deleted after the configuration of the widget, the version to load on start will revert to DEFAULT.
    • Version information (advanced style only)—Specify the version information that can appear in the version list for the selected data source. Available version information includes name, owner, access, creation date, description, common ancestor date, evaluation date, modified date, previous ancestor date, reconcile date, version GUID, and version ID.
    • Management capability (advanced style only)—Specify which version management parameters to allow for the selected data source.

      Version information and version management capability are based on a combination of the active portal user's privileges and the access permission of the version. End users lacking the required privileges will not see all version information or have access to version management options.

      • Switch versions—Allow to switch between versions.
      • Create new—Allow to create new versions.
      • Delete existing—Allow to delete existing versions.
      • Update name—Allow to update the version name.
      • Update description—Allow to update the version description.
      • Change owner—Allow to change the owner of the version.
      • Change access privileges—Allow to change the permission access level for the version (public, protected, or private).
      • Automatically refresh version list—Allow to automatically refresh the list of versions in the widget using an interval between 1 and 999 minutes.
  • General settings
    • Number of records per page—Specify how many versions to display on each page of the widget.
    • Expand versions list—Turn on this setting to expand the list of available versions when the widget loads.