Frequently asked question

Can table frame headers be changed without altering the field aliases in an ArcGIS Pro layout?

Last Published: September 4, 2025

No, table frame headers in an ArcGIS Pro layout cannot be changed independently of field aliases. By default, table frames display the field aliases defined in the attribute table as column headers. Refer to ArcGIS Pro: Add and modify table frame fields for more information. Any updates to the table frame headers must be made by modifying the field aliases associated with the feature layer.

However, when the aliases contain technical jargon or unclear terms, adjusting the headers with more user-friendly labels is necessary to improve map readability and interpretation. Refer to the following workarounds for instructions.

Update the attribute field aliases at the layer level

This workaround modifies the attribute field aliases on the map layer. Display-related settings created in the Contents pane are stored as properties of the map layer in the current map. This means the original feature layer properties, such as aliases, remain unchanged when the layer is added to another map. This workflow is recommended for multiple layouts, such as a map series, where manual placement adjustments are not required.

  1. Open the layout page with the table frame in ArcGIS Pro.
  2. Edit the layer-level attribute field alias of the current map.
    1. In the Contents pane, right-click the desired feature layer and click Data Design > Fields.
    2. In the fields view, double-click the Alias column of the desired field row, remove the existing text, and enter a new alias.
    3. On the ribbon, on the Fields tab, in the Manage Edits group, click Save.

The header of the selected field is updated with the new alias on the layout, as shown below.

The table frame in the ArcGIS Pro layout page

Add a temporary text box

This workaround overlaps the existing header with a temporary text box. This workflow is recommended for a single layout, where the text box is manually adjusted. It is not ideal for dynamic table frames for multiple layouts, such as in a map series, because repeated adjustments are required.

  1. Open the layout page with the table frame in ArcGIS Pro.
  2. Add a text box to the table header.
    1. On the ribbon, click the Insert tab.
    2. On the Insert tab, in the Graphic and Text group, click the Graphics and Text The 'Graphic and Text' gallery icon gallery drop-down arrow.
    3. In the Graphic and Text gallery, under Text, select Rectangle text The 'Rectangle text' icon.
    4. Click, drag, and release the cursor on the header to draw the text box.
    5. In the Element pane, under Text, type the desired header in the text box.
    6. Click the Display tab and set the Background symbol color to white.
    7. Click the Text Symbol tab and update the text formatting as necessary to match the existing header style. In this example, Font style is set to Bold to match the existing headers.

The header of the selected field is updated with a temporary text box on the layout.

The table frame in the ArcGIS Pro layout page

Convert the table to graphics and update the attribute field aliases

This workaround converts the table frame into graphics and removes the dynamic connection to the feature layer, preventing any changes in the feature layer from being reflected.

  1. Open the layout page with the table frame in ArcGIS Pro.
  2. Right-click the table frame and click Converts To Graphics.
  3. Update the header text.
    1. Click the header text to be updated.
    2. In the Element pane, under Text, enter the desired header in the text box and click any of the blank spaces in the pane to update the text box on the layout.

The selected header is updated with the specified text on the layout.

Image of the table frame with the updated header

Article ID: 000037507

Software:
  • ArcGIS Pro

Receive notifications and find solutions for new or common issues

Get summarized answers and video solutions from our new AI chatbot.

Download the Esri Support App

Get help from ArcGIS experts

Contact technical support

Download the Esri Support App

Go to download options