# Managing Assets in Orchestrator > 1. In the **Assets** page, select **Add**. The **Add Asset** window is displayed. 2. In the **Asset name** field, enter a name for the asset. 3. From the **Type** list, select the type of asset you want to create. 4. Add a **Description** of the asset. 5. Select the desired access scope from the **Access scope** section. * **Automations only**: allows asset values to be retrieved exclusively within automation related contexts. * **Automations and API**: allows asset values to be retrieved programatically via APIs and integrations, without requiring an automation context. 6. From the **Credential Store** list, select where this asset is stored from any of your defined credential stores. 7. Use the **Global Value** toggle to indicate whether this asset has a default value (used when no specific per-account/per-account-machine value exists). * If enabled, in the **Value** field, type what the asset should contain. If the asset type is boolean, select **True** or **False**, and if it is a credential enter the **Username** and **Password**. * If disabled, you must provide at least one account-specific asset value. 8. Use the **Add robot asset value** button to create the per-account or per-account-machine asset values desired. 9. Select **Create**. The asset is created and displayed on the **Assets** page. :::note * Once an asset is created, you cannot change the asset type. * If you create global-value credential or secret assets with the same Orchestrator name and the same external name in multiple Orchestrator folders, these assets point to a single object in the credential store. Therefore, any change you make to the asset in one of the Orchestrator folders affects all the identically named assets in the other Orchestrator folders. To avoid accidental changes to identically named credential or secret assets across Orchestrator folders, use a different external name for the asset in each folder. This ensures that the assets point to different objects in the credential store. ::: ## Creating assets 1. In the **Assets** page, select **Add**. The **Add Asset** window is displayed. 2. In the **Asset name** field, enter a name for the asset. 3. From the **Type** list, select the type of asset you want to create. 4. Add a **Description** of the asset. 5. Select the desired access scope from the **Access scope** section. * **Automations only**: allows asset values to be retrieved exclusively within automation related contexts. * **Automations and API**: allows asset values to be retrieved programatically via APIs and integrations, without requiring an automation context. 6. From the **Credential Store** list, select where this asset is stored from any of your defined credential stores. 7. Use the **Global Value** toggle to indicate whether this asset has a default value (used when no specific per-account/per-account-machine value exists). * If enabled, in the **Value** field, type what the asset should contain. If the asset type is boolean, select **True** or **False**, and if it is a credential enter the **Username** and **Password**. * If disabled, you must provide at least one account-specific asset value. 8. Use the **Add robot asset value** button to create the per-account or per-account-machine asset values desired. 9. Select **Create**. The asset is created and displayed on the **Assets** page. :::note * Once an asset is created, you cannot change the asset type. * If you create global-value credential or secret assets with the same Orchestrator name and the same external name in multiple Orchestrator folders, these assets point to a single object in the credential store. Therefore, any change you make to the asset in one of the Orchestrator folders affects all the identically named assets in the other Orchestrator folders. To avoid accidental changes to identically named credential or secret assets across Orchestrator folders, use a different external name for the asset in each folder. This ensures that the assets point to different objects in the credential store. ::: Field Description Asset name A custom name for the asset to help you identify it easily. Cannot exceed 256 characters. Type The type of the asset. The following options are available: Text : assets that can store string values. This is the default option. Bool : assets that can store a true or false value. If you select this option, the Value field displays two radio buttons ( True , False ). Integer : assets that can store integers. Credential : assets that can store credentials. If you select this option, the Value field is replaced by two others: Username , which may not exceed 512 characters, and Password , which may not exceed 25,000 characters. Secret : assets that can store secrets, such as API keys. Enter the secret value in the Secret field. The secret may not exceed 25,000 characters. Note: You can currently use secret-type assets only in conjunction with coded agents, which are indicated as Agent (<programming language>) . No process type with a Studio-created underlying package currently supports secret-type assets. Access scope Defines where the asset value can be accessed from. Use this setting to control whether the asset is available only within automation workflows or also through APIs and integrations. The following options are: Automations only: the asset value can be used only within automation workflows. Automations and API: the asset value can also be accessed programmatically through APIs and integrations. Credential Store Available only when adding credential or secret assets. The credential store where the asset will be saved, whether the native Orchestrator database or any of your created external stores. Note: You cannot retrieve secret-type assets from an external credential store when using a disconnected proxy. External Name Available only when adding credential or secret assets to a credential store. The name of the asset to be used when communicating with the credential store. Global Value A global-value asset is received by all accounts, except those with specific asset values (defined using the Add robot asset value button). When this option is enabled, you must enter the global value that is received by accounts: For Bool assets, two radio buttons, True and False , are displayed. By default, False is selected. For Credential assets, the Username and Password fields are enabled. You must populate both fields. For Secret assets, you must enter a value in the Secret field. For text assets, this field allows for up to 1,000,000 characters. Add robot asset value Enables you to add specific asset values on a per account or per account-machine basis. When not using the Global Value option, you must configure at least one specific value. If a global value is provided, adding specific values is optional. For Bool assets, two radio buttons, True and False , are displayed. By default, False is selected. For Credential assets, the Username and Password fields are enabled. You must populate both fields. For Secret assets, you must enter a value in the Secret field. For text assets, this field allows for up to 1,000,000 characters. ## Managing Asset Links Sharing assets between folders enables launching jobs in multiple folders without redesigning your workflows in Studio when the underlying processes are targeting the same asset. Linking an asset to a folder makes the asset and all asset-associated objects, such as asset items, available in that folder. :::important You can only share assets with global values and no specific value per account. You cannot share assets with values per account between folders. ::: :::note An asset linked to multiple folders is marked using the ![](https://dev-assets.cms.uipath.com/assets/images/orchestrator/orchestrator-image-linked_icon-f53242d2-6d93c5d8.png) icon. If the icon is not present, then the current folder is the only folder the asset resides in. Deleting it here completely removes the asset from Orchestrator. You need the **Assets - Create** permission in the folders where you want to add the asset (target folders) and **Assets - View** in the folder where the asset currently resides (original folder). If you have **Assets - Edit** in the target folder, you do not need **Assets - Edit** in the original folder. Once an asset is shared to a folder, users with **Assets - Edit** in the destination folder can edit the asset, and the changes will apply globally. ::: ### Linking Multiple Assets to the Current Folder 1. In the folder you want to link an asset to, on the **Assets** page, click **Add**. Three buttons are displayed allowing you to add an asset, link assets from other folders, or hide the options. 2. Select **Link from other folders**. The **Link Assets** window is displayed showing a list of all assets in the folders in which you have View permissions on Assets. Figure 1. Linking assets from other folders ![Screenshot of Link Assets from other folders page](https://dev-assets.cms.uipath.com/assets/images/orchestrator/orchestrator-screenshot-of-link-assets-from-other-folders-page-233171-546d4a92-e5777e5d.webp) 3. On the **Select Assets** section, select one or multiple assets from the list. 4. Select **Continue**. You are directed to the **Folder Validation** section. Here you can see the folders the assets are already linked to. If there are multiple folders, their names are displayed. Figure 2. Validating folder ![Screenshot of the Folder Validation page](https://dev-assets.cms.uipath.com/assets/images/orchestrator/orchestrator-screenshot-of-the-folder-validation-page-225945-c3f186c5-fd9a7db4.webp) 5. Select **Remove** for the corresponding asset to revert the change or click **Exit** to cancel the operation. 6. Select **Link** if you want to make the link between the assets you selected and the current folder. The assets are displayed on the **Assets** page. ### Linking an Asset to Multiple Folders 1. Navigate to a folder the asset to be linked resides in. Select **More Actions** > **Manage Links** for the desired asset to open the **Manage Links** window. The **Manage Asset Links** window is displayed. Figure 3. Managing Asset links ![Screenshot of the Manage Asset Links page](https://dev-assets.cms.uipath.com/assets/images/orchestrator/orchestrator-screenshot-of-the-manage-asset-links-page-233151-df7b1090-2b93a383.webp) 1 - Left-hand pane displaying all the folders you have been granted **View** permissions on Assets. 2 - The current state of the asset displaying the number of folders it currently resides in as well as their names. 3 - The folders the asset is to be added in according to your selection in the left-hand pane. 4 - The folders the asset will be removed from. 1. Select **Update**. A confirmation window is displayed. 2. Select **Cancel** if you want to abort the changes or **Continue** for the changes to take effect. The operations are now reflected in Orchestrator according to your changes. ### Unlinking Assets From Folders Unlinking assets from folders can be performed in a manner similar to the linking operation. Navigate to the link-management areas presented in the procedures above and remove the connections between a certain asset and a certain folder. Alternatively, you can remove an asset using the **Remove** functionality. See [Removing an Asset](https://docs.uipath.com/orchestrator/automation-cloud/latest/user-guide/managing-assets-in-orchestrator#removing-assets). :::important Removing an asset that exists in multiple folders only removes it from the folder where the removal operation takes place, it does not remove it from the other folders as well. In order to completely delete an asset, you must remove all its existing links. ::: ## Editing Assets To edit an asset, click **More Actions** > **Edit** button, make the necessary changes and click **Update** in the **Update Asset** window. Only the asset value and name can be edited. All changes are audited and can be viewed in the [Audit](https://docs.uipath.com/orchestrator/automation-cloud/latest/user-guide/about-audit#audit) page. If you change the username of a credential asset, you have to also change the password. ## Removing per-user and per-robot asset values You can remove asset values defined for specific users or robots directly from the asset editor. 1. Open **Assets**. 2. Create a new asset or edit an existing asset. 3. In the **Asset value** section, choose the value you want to remove. 4. Select **Remove**. 5. Select **Delete** in the confirmation dialog. You can also select multiple entries and remove them simultaneously using the **Remove** option in the grid header. ## Adding Tags to Assets :::note You need **Edit** on Assets and **View** on Tags to add existing tags to assets. You need **Edit** on Assets and **Create** on Tags to add new tags to assets. ::: :::note * Each asset can have a maximum of one million key/value pairs. * Labels and key/value properties are limited to 256 characters. * Tag names can't contain these characters: `<`, `>`, `%`, `&`, , `?`, `/`, `:`. ::: You can apply tags to a asset either when creating one or editing an existing one. To add tags to a asset when editing it, follow these steps: 1. From the **Assets** page, click **More Actions** > **Edit** next to the desired asset. The asset is opened for editing. 2. On the **Labels** field, start typing the name of the label. You can choose an existing label or create a new one. 3. On the **Properties (key-value pairs)** field, click **Add new**. 4. Add new keys and values. You can choose existing keys and/or values or you can create new ones. 5. When done, click **Update**. Your asset is updated and the newly created tags, if any, become available for other objects. ## Removing Tags From Assets To remove tags from a asset, follow these steps: 1. From the **Assets** page, click **More Actions** > **Edit** next to the desired asset. The asset is opened for editing. 2. On the **Labels** field, click the **X** adjacent to the name of the label to remove it. The label is removed. 3. On the Properties (key-value pairs) field, click the **X** adjacent to the keys and/or values to remove them. The keys and/or values are removed. 4. To delete a key/value pair click the **Remove** icon corresponding to that entry. The key/value pair is removed. 5. When done, click **Update**. Your asset is updated and tags are removed. ## Removing Assets To remove an asset, click **More Actions** > **Remove**. Alternatively, you can select one or multiple assets and click the **Remove** button.