Information for: DEVELOPERS   PARTNERS

Organizing applications with tags

With application tagging, if you have many applications in your Acquia Cloud interface, you can better organize and manage those applications by adding custom tags to each application. Acquia Cloud allows you to manage applications’ tags both through the Acquia Cloud interface or with the Acquia Cloud API. Tagging your applications enables them to be filtered by tag in the Acquia Cloud interface (displaying only the applications in which you are interested), and let you run reports based on custom criteria.

Application tagging is available for all Acquia Cloud subscription levels. However, only users with Administrator and Team Lead roles have permissions to add and remove tags in the Acquia Cloud user interface. For a complete list of permissions assigned to each Acquia Cloud user role, see Default Acquia Cloud user permissions.

Application tags are shared for use with any application in a single organization. Based on all tags being shared in this manner, Acquia Cloud doesn’t support private or personal tags for applications. Tags can’t be shared between organizations.

For Acquia Cloud Site Factory subscribers

Regardless of their creation method, application tags created for Acquia Cloud don’t display in the Acquia Cloud Site Factory interface.

Adding tags to an application

To add a single tag to an application, complete the following steps:

  1. Sign in to Acquia Cloud.

  2. Use the procedure based on your currently displayed page in the Acquia Cloud interface:

    • Applications page: Click the plus icon ( + ) in the card of the application you want to tag.

      Click the plus sign in the application card

    • Environments page: Click the plus icon ( + ) at the top of the page.

      Click the plus sign in the application card

  3. In the dialog box that appears, enter a text label for your tag, based on the labeling requirements. If tags have been previously added to applications in your organization, Acquia Cloud displays any tags that match your provided text.

  4. Select a color for your tag.

    Dialog box for adding tag label and color

  5. Click OK.

Acquia Cloud will add a tag to your application with the label and color you selected. You can now 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 Acquia Cloud user interface; however, an Acquia Cloud API endpoint is available that supports tagging multiple applications simultaneously.

Changing previously-created tags

You cannot modify a previously-created application tag. To change a tag, you must remove the tag from all applications to delete the application tag from Acquia Cloud, 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 an application

To remove a tag from an application, complete the following steps:

Note

If an application tag that you want to remove from one application is associated with another application in your organization, Acquia Cloud will continue to display the tag as a suggested option when adding tags to other applications.

  1. Sign in to Acquia Cloud.

  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. Acquia Cloud will display an X icon.

    Deleting a tag from an application

  4. Click the X icon, and then click Confirm to remove the tag.

Acquia Cloud removes the tag from this application. If the tag you removed isn’t associated with any other application, Acquia Cloud 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 in the existing input filter on the Applications page by completing the following steps:

  1. Sign in to Acquia Cloud.

  2. On the Applications page, locate the Filter Applications field in the top right of the page.

    Filtering by tag label displays all matching applications

  3. In the Filter Applications field, enter the text by which to filter.

Acquia Cloud displays applications with titles or tags matching your text.

Application tagging with the Acquia Cloud API

The Acquia Cloud API v2 provides the following application tagging endpoints: