> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/datasets/manage-datasets/add-tags-to-images.md). # Add Tags to Images Roboflow provides an image tagging feature. This feature allows you to assign tags to images during upload. You can use these tags for batch assignment for labeling, enabling greater precision when assigning images for labeling. Furthermore, you can use image tags as a parameter in the Roboflow dataset search associated with your dataset. ### Assigning a Tag During Upload You can assign tags during data upload both in the web interface and using the [REST API and Python SDK](https://docs.roboflow.com/api-reference/images/upload-api). The image below shows how to specify tags to associate with images uploaded using the web interface:

Opening the Tag menu prior to image Upload

### CLI You can add and remove tags on existing images using the `roboflow image metadata` command: ```bash # Add tags to an image roboflow image metadata --tags "reviewed,v2" # Remove tags from an image roboflow image metadata --remove-tags "draft,needs-review" # Add and remove tags in one call roboflow image metadata --tags "approved" --remove-tags "pending" # Batch update tags on multiple images roboflow image metadata img1,img2,img3 --tags "processed" --poll ``` You can also pass tags during upload with `roboflow image upload`: ```bash roboflow image upload photo.jpg -p my-project --tag "review,v2" ``` ### Apply Tags in the Images Tab To apply tags in the Image tab, click on the images to which you want to apply tags, click the "Images Selected" button in the top right corner of the page, and then click "Apply tags". This will allow you to add an arbitrary number of tags to the selected images.

### Rename or Delete Tags Across a Project To rename or delete tags across all images in a project, open the "Tags" tab in the project "Settings" page. 1. Select the tags you want to modify using the checkbox column. 2. Click "Rename" or "Delete" in the toolbar. 3. For renames, enter the new name for each tag, click "Review Changes", then "Confirm Changes". 4. For deletes, review the list and confirm. ### Filter Images by Tag You can filter images using tags in the Assign page on the Roboflow dashboard:

Filtering by Existing dataset Tags from within the Assign tool

### Use Tags to Curate Data in Versions The [Filter by Tag](https://docs.roboflow.com/datasets/image-preprocessing#filter-by-tag) preprocessing step allows you to create Versions of your dataset that include or exclude specific data. Use this preprocessing step to train or export only a curated slice of your data.

Use the "Filter by Tag" preprocessing step to require or block certain tags from entering a dataset version.

--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.roboflow.com/datasets/manage-datasets/add-tags-to-images.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.