Field aliases of shapefiles are not preserved in the ArcGIS Enterprise portal or ArcGIS Online

Description

In the ArcGIS Enterprise portal or ArcGIS Online, shapefiles can be added as an item to create a hosted feature layer. However, the resulting feature layer does not have field aliases preserved, and both the field and display names are identical.

In this example, the shapefile is created in ArcGIS Pro with different field names and field aliases. However, when the shapefile is directly published to ArcGIS Online, the feature layer’s display names follow the field names instead of the field aliases.

Cause

This behavior is a known limitation for shapefiles when directly published to the ArcGIS Enterprise portal or ArcGIS Online. They use the dBASE file format (.dbf) to store attributes, which does not support field aliases, unlike geodatabases. Shapefiles can have aliases when referenced within a map document or layer file, but not as a stand-alone file or when shared without a layer file. Refer to ArcGIS Pro: Geoprocessing considerations for shapefile output for more information.

Solution or Workaround

Configure the shapefile’s layer pop-ups in ArcGIS Pro

1. Open ArcGIS Pro and add the shapefile to the project.
2. Modify the shapefile layer's field aliases using the Configure Pop-ups pane.
   1. In the Contents pane, right-click the shapefile layer and click Configure Pop-ups.
   2. In the Configure Pop-ups pane, click Edit pop-up element .

1. 3. In the Fields Options pane, uncheck Only use visible fields and Arcade expressions.
   4. Hover over a field in the table and click Format the field to modify the field alias.

1. 5. In the Pop-up Field Formatting pane, specify the field alias for Display Label and click Back .

3. In the Contents pane, right-click the shapefile layer and click Sharing > Share As Web Layer to share the shapefile layer as a web layer in ArcGIS Online or ArcGIS Enterprise portal. Refer to ArcGIS Pro: Share a web feature layer for instructions.

Note:
If the Share As Web Layer option is unavailable, close the shapefile layer's fields view.

The field aliases of the hosted feature layer are preserved in ArcGIS Online.

Modify the shapefile layer's field aliases using the fields view in ArcGIS Pro

1. Open ArcGIS Pro.
2. Add the shapefile to the project and open the fields view.
3. In the fields view table, double-click the field under the Alias column and edit the alias.

4. Repeat Step 3 to modify the remaining aliases as required and click Save on the top ribbon.
5. In the fields view, click Close .
6. In the Contents pane, right-click the shapefile layer and click Sharing > Share As Web Layer to share the shapefile layer as a web layer in ArcGIS Online or Portal for ArcGIS. Refer to ArcGIS Pro: Share a web feature layer for instructions.

The field aliases of the hosted feature layer are preserved in ArcGIS Online.