--- title: "Organizing applications with tags" date: "2024-02-14T06:18:38+00:00" summary: "Streamline application management with custom tags in Cloud Platform. Organize, filter, and report on your apps efficiently. Learn how to add, remove, and use tags for better workflow." image: type: "page" url: "/acquia-cloud-platform/organizing-applications-tags" id: "6dccbeaa-1e29-4228-9075-834b2c7801ef" --- Table of contents will be added With _application tagging_, if you have many [applications](/acquia-cloud-platform/manage-apps) in your Cloud Platform interface, you can better organize and manage those applications by adding custom tags to each application individually, or [in bulk](#). Cloud Platform allows you to manage applications’ tags both through the [Cloud Platform user interface](#cloud-app-tag-add) or with the [Cloud Platform API](#cloud-app-tag-api). Tagging your applications enables them to be filtered by tag in the Cloud Platform user interface (displaying only the applications in which you are interested), and lets you run reports based on custom criteria. Applications can have more than one tag, and in those cases, Cloud Platform displays tags sorted alphanumerically. For example: `1Tag`, `TAg`, `Tag1`, and `tag`. Application tagging is available for all Cloud Platform subscription levels. However, only users with _Administrator_ and _Team Lead_ roles have permissions to [add](#cloud-app-tag-add) and [remove](#cloud-app-tag-remove) individual tags in the Cloud Platform user interface. Only users with _Owner_ or _Administrator_ roles may [add or remove tags in bulk](/acquia-cloud-platform/manage-apps/cloud-platform-interface/tags/bulk). For a complete list of permissions assigned to each Cloud Platform user role, see [Default Cloud Platform user permissions](/acquia-cloud-platform/access/teams/permissions/default). Application tags are shared for use with any application in a single [organization](/acquia-cloud-platform/access/teams/organizations). Based on all tags being shared in this manner, Cloud Platform doesn’t support private or personal tags for applications. Tags can’t be shared between organizations. For Site Factory subscribers Regardless of their creation method, application tags created for Cloud Platform don’t display in the Site Factory interface. Adding tags to a single application ----------------------------------- Note For information on bulk adding application tags to many applications, see [Bulk adding tags to many applications](/acquia-cloud-platform/manage-apps/cloud-platform-interface/tags/bulk#cloud-bulk-app-tag-add). To add a single tag to an application: 1. [Sign in to the Cloud Platform user interface](/node/55875) as a user with the _Administrator_ or _Team Lead_ role. 2. Use the procedure based on your currently displayed page in the Cloud Platform interface: * **Applications** page: Click the plus icon ( `+` ) in the card of the application you want to tag. ![cloud-platform_tagging-from-application-list.jpg](https://acquia.widen.net/content/022fdd79-e198-4654-95af-1c5c51444ae6/web/cloud-platform_tagging-from-application-list.jpg) * **Environments** page: Click the plus icon ( `+` ) at the top of the page. ![cloud-platform_tagging-from-environments-page.png](https://acquia.widen.net/content/1c758ded-a8d4-49ec-abd8-0b88a7f52338/web/cloud-platform_tagging-from-environments-page.png?w=480&itok=ZqfSaVUa) 3. In the dialog box that appears, enter a text label for your tag, based on the [labeling requirements](#tags-labeling). If tags have been previously added to applications in your organization, Cloud Platform displays any tags that match your provided text. 4. Select a color for your tag. ![cloud-platform_selecting-color-for-tag.png](https://acquia.widen.net/content/92366d7b-e510-4eb6-aacd-f4ca89f9ca92/web/cloud-platform_selecting-color-for-tag.png) 5. Click **OK**. Cloud Platform will add a tag to your application with the label and color you selected. You can now [filter](#cloud-app-tag-filter) for this tag on the **Applications** page. You can add tags, one at a time, to applications in your organization. You can’t, however, apply a tag to multiple applications simultaneously in the Cloud Platform user interface; however, an [Cloud Platform API endpoint](#cloud-app-tag-api) is available that supports tagging multiple applications simultaneously. Updating tags You cannot change an application tag after creating it. To change a tag, you must [remove the tag](#cloud-app-tag-remove) from all applications to delete the application tag from Cloud Platform, and then recreate the tag with your required changes. ### Requirements for tag label names Application tag label names must meet the following requirements: * 16 characters or fewer, with no spaces. The tag name can contain special characters, including underscores ( `_` ) and dashes ( `-` ). * Tag names are case-sensitive: For example, `example` and `EXAMPLE` are distinct tags. * Tag color and label are paired. If you create a green `EXAMPLE` tag, you can’t create a red `EXAMPLE` tag. Removing tags from a single application --------------------------------------- To remove a tag from an application: Note * For information on bulk removing tags from multiple applications, see [Bulk removing tags from many applications](/acquia-cloud-platform/manage-apps/cloud-platform-interface/tags/bulk#cloud-bulk-app-tag-remove). * If an application tag that you want to remove from one application is associated with another application in your organization, Cloud Platform will continue to display the tag as a suggested option when adding tags to other applications. 1. [Sign in to the Cloud Platform user interface](/node/55875). 2. On the **Applications** page, locate the application card displaying the tag you want to remove. 3. Point to the tag you want to remove. Cloud Platform will display an `X` icon. ![cloud-platform_removing-tags.png](https://acquia.widen.net/content/3e7d7618-3f49-4a13-b206-2afafb94c852/web/cloud-platform_removing-tags.png) 4. Click the `X` icon, and then click **Confirm** to remove the tag. Cloud Platform removes the tag from this application. If the tag you removed isn’t associated with any other application, Cloud Platform will permanently _delete_ the tag. Note Acquia cannot restore application tags that have been deleted. Filtering applications by tag ----------------------------- After your applications have been tagged, you can filter based on tag labels by appending a hashtag `(#)` to the tag label in the existing input filter on the **Applications** page. To do this: 1. [Sign in to the Cloud Platform user interface](/node/55875) as a user with the _Administrator_ or _Team Lead_ role. 2. On the Applications page, locate the **Filter applications** field in the top left of the page. ![cloud-platform_filtering-by-hashtag-and-tag-label.jpg](https://acquia.widen.net/content/7906f855-1f1d-436f-a06f-69b2f0c4cbd1/web/cloud-platform_filtering-by-hashtag-and-tag-label.jpg) 3. In the **Filter Applications** field, enter the text and add **#** in front of the text that you want to filter (for example, `#docs`). Cloud Platform displays applications with titles or tags matching your text. Application tagging with the Cloud Platform API ----------------------------------------------- The [Cloud Platform API v2](/acquia-cloud-platform/develop-apps/api) provides the following application tagging endpoints: * [Create a new application tag](https://cloudapi-docs.acquia.com/#/Applications/postApplicationsTags) * [Delete an application tag](https://cloudapi-docs.acquia.com/#/Applications/deleteApplicationTags) * [Return a list of tags associated with an application](https://cloudapi-docs.acquia.com/#/Applications/getApplicationTags)