.. _Modify_Replace:

Modify > Replace
""""""""""""""""

This feature is available from the :ref:`ModifyMenu` or all editable assets that have an identifier (URI).
It can be used to replace the URI of the asset, essentially renaming the identifier.
A dialog open where you can modify the URI.

.. caution::
   Changing the identifier/URI of an asset should be taken with care, in case the asset is also referenced
   in other asset collections.
   In particular, be careful when you replace URIs of classes or properties.

The Replace dialog therefore has a button that allows you to review any usages in other asset collections
before you replace the URI of the asset.

.. hint::
   The safest way to replace a URI that may be used across other asset collections is to identify
   an asset collection that includes all other collections that may mention the URI.
   Then create a workflow where you also edit these included collections.
   In that workflow, perform the replace operation.
   The replace would then be applied to each asset collection on commit of the workflow.


**See Also**

* :ref:`Modify_Merge`
* :ref:`Modify_ReplaceNamespace`
* :ref:`Modify_ReplaceURIAcrossGraphs`

**Further Reading on Modify Menu**

* :ref:`scripting_actions`

**Further Reading on TopBraid**

* :ref:`introduction`