How to Tag Droplets

Tags allow you to apply custom labels to a Droplet. You can filter tagged Droplets, automatically include Droplets in Firewall or DigitalOcean Load Balancer configurations by tag, and use the DigitalOcean API to initiate an action across multiple Droplets with the same tag.

Choosing terms that describe a Droplet’s function can help you locate and administer Droplets that share common roles. For example, you might tag Droplets by:

  • Environment, like production, staging or development.
  • Application, like web servers (Apache) or database servers (MariaDB).
  • Purpose, like a project name or any other key term that describes the use of the Droplet.
  • Person, like the individual or team responsible for managing the Droplet.

You can add tags to Droplets during creation or after.

Limits

  • Tags must be a single word.
  • You cannot edit existing tags. Instead, create a new tag and delete the old one.

Tag Droplets During Creation

To add tags while creating a new Droplet, at the bottom of Droplet create page, look for the Finalize and create section.

The Finalize and Create section of the Droplet creation menu, including the Add tags section.

Under the Add tags header, enter the tags you want to use for the Droplet. Add tags by pressing SPACEBAR or ENTER after each term. Navigate between tags with the arrow keys, and remove the highlighted tag with DELETE or the last tag on the list with BACKSPACE.

Tag Existing Droplets

To add or modify tags for existing Droplets, use the Droplet’s More menu and select Edit tags or, from the Droplet’s detail page, use the Tags link.

The Droplet tags page

Additionally, on a project’s dashboard, you can hover over an untagged Droplet’s row of information to reveal the Add tags link.

No matter which way you navigate, the Manage Tags window will open.

The Manage Tags window

Add tags by pressing SPACEBAR or ENTER after each term. Navigate between tags with the arrow keys, and remove the highlighted tag with DELETE or the last tag on the list with BACKSPACE.

When you’re done, click Save Tags.

Filter by Tag

If you click on a tag from anywhere in the control panel (like on the dashboard of a project or on a Droplet’s Tags page), you will go to the list of all resources with that tag.

An example of a list of resources with a tag. There are 3 Droplets with the tag 'webserver'.

Filter lists are limited to a single tag, displayed at the top of the list.