PROBLEM

Unable to update feature template in ArcGIS Enterprise portal

First Published: January 20, 2026
Last Published: September 8, 2026

Description

Templates configured using Copy Templates cannot be edited in Map Viewer in the ArcGIS Enterprise portal when the feature layer references registered data and the following error message is returned:

Error:   
Unable to save your template changes
Check the layer settings and confirm that you have privileges required to make changes
The error message in Map Viewer

Inspecting the network traffic, the following error is returned:

Error:   
{"error": {
  "code": 500,
  "details": [],
  "message": "Error performing update definition operation"
}}
The error message in ArcGIS REST API

Cause

To manage feature templates in Map Viewer, the feature layer must be a hosted feature layer. Managing feature templates for layers that reference registered data is not supported.

Solution or Workaround

Update the template using ArcGIS Pro

  1. Open the ArcGIS Pro project and click Project > Portals.
  2. Log in to the ArcGIS Enterprise portal and set it as the active portal.
  3. Click the back Icon for back icon.
  4. Regenerate templates to match the current layer configuration without changing the existing correct templates. Refer to ArcGIS Pro: Create all feature templates for a map or a layer for instructions. In this example, the Target Feature map is regenerated.
  5. In the Manage Templates pane, in the layer view, click the target layer. In this example, the selected layer is the Point layer under the Target Feature map.
  6. In the template view, click the preferred template and click Properties. In this example, the selected template is Point.
The image shows the Manage Templates pane with the selected layer
  1. In the Template Properties pane, on the General tab, review and configure the preferred properties. Click OK. In this example, the Description for the Point layer template properties is specified.
The image shows the Template Properties pane for the Point layer with its configured description
  1. Share the feature layer to the ArcGIS Enterprise portal. For Data and Layer Type, under Reference registered data, select Feature. In this example, Name is specified as Target_feature Templates_Copy.
The image shows the Share As Web Layer pane with the configured details and data type

The image shows the template editing configuration with the description edited in ArcGIS Pro.

The image shows the template configuration retaining the description from ArcGIS Pro

Publish the feature layer using 'Copy all data' from ArcGIS Pro

  1. Repeat Steps 1 through 3 from the previous workaround.
  2. On the Share tab, in the Share as group, click Web Layer.
  3. Share the feature layer to the ArcGIS Enterprise portal. For Data and Layer Type, under Copy all data, select Feature. In this example, Name is specified as Target_feature Templates_Copy.
The image shows the Share As Web Layer pane with its configuration

A message indicating that the template changes were successfully saved is returned when the layer is shared using 'Copy all data'.

The image shows the template changes were successfully saved

Article ID: 000039990

Software:
  • ArcGIS Pro
  • ArcGIS Enterprise

Get support with AI

Resolve your issue quickly with the Esri Support AI Chatbot.

Start chatting now

Related Information

Discover more on this topic

Get help from ArcGIS experts

Contact technical support

Start chatting now

Go to download options