Set a replacement item

At this release, you can designate a replacement item for the following app item types that will soon retire:

• ArcGIS Configurable Apps
• Classic Esri Story Maps

You can suggest a replacement item for these apps to guide users to an appropriate substitution. Users who find one of these items in the organization will see a badge () indicating that a different item should be used instead.

When users open the item page of the app item to be replaced, a pop-up message appears on the Overview tab that contains a link to the replacement item's page. This allows the user to determine whether the suggested replacement meets their needs.

In the future when these app item types are retired, consumers of the existing apps—such as websites or dashboards—will be directed automatically to the replacement that you set.

You can specify one replacement item per deprecated app item.

Tip:

You do not have to own the replacement item, but ensure that the replacement item is shared with the same audience as the item it will replace. If you are not the owner of the replacement item or you are not an organization administrator, contact the item owner to request that the sharing settings be changed. If the sharing setting cannot be altered, consider designating a different replacement item.

At this time, the option to set a replacement item is only available for app item types that are retiring soon.

To designate a replacement item, follow these steps:

1. Sign in to the organization.

   You must sign in as the item owner or as a member of the default administrator role.

2. Open the item page and click the Settings tab.
3. Click Select item.

   The Select replacement item pop-up appears.

4. Browse to and select the replacement item.

   Use the filters and search to find items. To determine whether the item is a suitable replacement, click Preview on the item card to review information about the item.

5. After you choose a replacement, click Select.

   The Select replacement item pop-up closes, and the replacement item is listed on the Settings tab of the deprecated item.

To change replacement items, remove the replacement item from the Settings tab and follow the steps above to designate a new replacement.