Repair project items

When you open a project, ArcGIS Pro validates your item connections. If a connection is invalid, it appears with a red exclamation point .

The connection to the Land folder is invalid. The folder and its contents are inaccessible.

An item connection is invalid when the item is not found at the expected location. This can happen if the item is moved, renamed, or deleted; or if its path changes. For example, if you make a folder connection to C:\Data\Land, and later rename the Data folder to MyData in File Explorer, the folder connection becomes invalid.

An item connection may become invalid during your ArcGIS Pro session. This happens, for example, if a folder or database that is an item connection is moved or deleted in File Explorer while your project is open. In these cases, the connection is marked as invalid when you refresh the connection or try to access the item.

Note:

Connections do not become invalid if you move, rename, or delete items using ArcGIS Pro commands in your current ArcGIS Pro session. They become invalid only if changes are made by other applications or by concurrent instances of ArcGIS Pro.

Connections to network drives, servers, enterprise geodatabases, and other remote items can become invalid for other reasons, such as the availability of the host computer. These invalid connections are described further in the section Repair invalid server and database connections below.

Only connections to items stored outside an ArcGIS Pro project file (.aprx) can become invalid. These include toolboxes, notebooks, databases, servers, and folders. Items that are favorites can also become invalid. Items stored inside the ArcGIS Pro project file, such as maps, layouts, and reports, cannot become invalid. However, items whose data sources reference invalid connections can be invalid. For example, a map layer becomes invalid (broken) if its data source is a feature class in an invalid geodatabase connection. See Update data sources for more information on repairing map layers and tables.

Required connections in an ArcGIS Pro project—specifically, the default geodatabase and default toolbox connections—are not allowed to become invalid. A project’s default geodatabase or toolbox should not be deleted, moved, or renamed. However, if this happens, new default items are created and added to the project. The invalid items still appear in the project and can be repaired but are no longer the default items.

Repair an invalid connection in the Catalog pane or catalog view

In the following steps, an invalid database connection is repaired from the Catalog pane. You can follow the same steps to repair any type of invalid connection in either the Catalog pane or a catalog view. You can also repair an invalid connection from a browse dialog box, but using the Catalog pane or catalog view is recommended.

In this example, the database connection to the Boundaries file geodatabase is invalid because the geodatabase was moved from the C:\Data folder to the C:\FinalData folder by another application, such as ArcMap or File Explorer.

1. Click Repair project item next to the geodatabase.

   Tip:

   Hover over an item to see its expected path. In this example, ArcGIS Pro looks for the geodatabase in the C:\Data folder but doesn’t find it there. The path does not appear as a link because the connection is invalid.

2. In the Repair Geodatabase browse dialog box, browse to the new location of the geodatabase.

   If you don’t know the item's new location, you can search for it with operating system commands. You cannot search invalid connections or their contents within ArcGIS Pro.

3. Click the geodatabase to select it.

   

   The updated path to the geodatabase is shown in the location bar.

4. Click OK.

   

   A prompt to repair maps and other items appears. If items in your project, such as map layers, reference feature classes in the invalid geodatabase, these map layers are also invalid. (They appear with red exclamation points if you open the map that contains them.) The Repair prompt gives you the option to repair these related items.

5. On the Repair prompt, click Yes or No according to your preference.
   • Click Yes if you want ArcGIS Pro to inspect and repair map layers and other project items that reference data sources contained in the item connection.
   • Click No if you want to repair invalid project items later (or if you are sure that no data sources in the item connection are referenced).

   In the Catalog pane, the database connection is now valid and the red exclamation point is removed. If you hover over the item, its updated path displays as a link.

   

   Sometimes a connection cannot be repaired. For example, the item may have been deleted. You can remove a connection from your project if it can’t be repaired.

   Note:

   If you use File Explorer, or another application outside of ArcGIS Pro, to return an item to its expected location or rename it to its expected name, the connection validity is restored. You can remove the red exclamation point by refreshing the connection.

Repair invalid server and database connections

Connections to servers, enterprise geodatabases, and cloud items may appear valid when you open a project but display as invalid when you try to access the connection. This happens when the connection file is found in its expected location (for example, in your project home folder) but the remote computer or its resources are unavailable for some reason. A server may be offline, access credentials may have changed, or some other problem external to ArcGIS Pro may have occurred. When you try to access the connection, an error message identifying the problem appears.

If the problem is related to access credentials, you may be able to resolve it in ArcGIS Pro by right-clicking the connection, clicking Properties (for a server) or Connection Properties (for an enterprise database), and changing the settings. If necessary, contact your server or database administrator for help.

When the problem is corrected, refresh the item connection in the Catalog pane or catalog view to remove the red exclamation point and access the item.

Repair project items that become invalid during a session

Specific items contained by a valid item connection may become invalid during an ArcGIS Pro session. This occurs in folder connections that contain other folders, toolboxes, and geodatabases. For example, if a subfolder of a valid folder connection is moved to a new location with File Explorer, the subfolder becomes invalid. (Any item container can become invalid. Items that do not contain other items, such as feature classes or stand-alone files, do not become invalid.)

The invalid item displays a red exclamation point when you try to access it.

The connection to the Local folder is valid. However, the Shapefiles subfolder is invalid—it may have been moved or deleted during the current ArcGIS Pro session. If you try to add the shapefiles to a map, you’ll get an error.

If an item in a folder connection becomes invalid, refresh the folder connection that the invalid item belongs to. Refreshing the connection has one of the following effects:

• If the item has been renamed or moved to another location within the item connection folder, the refreshed connection displays the item with its new name or in its new location. The item is now valid.
• If the item has been deleted or moved to a location that is not within the item connection folder, the refreshed connection no longer displays the item.

Note:

You cannot repair an item that has been deleted or moved to a location outside the folder connection by clicking the item’s exclamation point and following the steps you use to repair an item connection. The item no longer exists in the location where it is shown as invalid; therefore, it cannot be made valid in that location.

Repair favorites

An item in your project favorites becomes invalid if the item it references is invalid. For example, if you add a folder on your computer to your favorites and the folder is later moved to a different location, the favorite becomes invalid—just as a folder connection to that same folder becomes invalid.

You repair a favorite in the same way that you repair an item connection: click the red exclamation point that appears next to the favorite and browse to the item’s location in the repair dialog box.

When you repair an invalid favorite, you also repair invalid connections to that item in your projects. Likewise, when you repair an invalid item connection in your project, you repair the same item in your favorites collection.