---
url: /en/build/internal-steps/artifact/remove-tag.md
---
`artifact:remove-tag`

\==Delete CNB Artifact Tags==, currently only supports deleting CNB Docker and Helm tags.
Write permissions for the repository are required.

* [Applicable Events](#artifact-remove-tag-applicable-events)
* [Parameters](#artifact-remove-tag-parameters)
* [Configuration Examples](#artifact-remove-tag-configuration-examples)

## Applicable Events {#artifact-remove-tag-applicable-events}

* `push`
* `commit.add`
* `tag_push`
* `tag_deploy`
* `pull_request.merged`
* `api_trigger`
* `web_trigger`
* `crontab`
* `branch.create`

## Parameters {#artifact-remove-tag-parameters}

The list below gives an overview of all `artifact:remove-tag` parameters.

* [name](#artifact-remove-tag-parameters-name): Artifact package name
* [tags](#artifact-remove-tag-parameters-tags): List of tags to remove
* [type](#artifact-remove-tag-parameters-type): Artifact type; only Docker and Helm are supported (default `docker`)

Detailed descriptions for each parameter are provided below.

### name {#artifact-remove-tag-parameters-name}

* type: `String`
* required: `true`

Artifact package name

### tags {#artifact-remove-tag-parameters-tags}

* type: `Array<string>`
* required: `true`

### type {#artifact-remove-tag-parameters-type}

* type: `String`
* required: `false`
* default: `docker`

Artifact type, currently only supports Docker and Helm

## Configuration Examples {#artifact-remove-tag-configuration-examples}

```yaml title=".cnb.yml"
main:
  push:
    - stages:
        - name: remove tag
          type: artifact:remove-tag
          options:
            # Package name
            # Package name example 1, repository with the same name artifact: reponame
            # Package name example 2, repository with a different name artifact: reponame/name
            name: reponame/name
            tags:
              - tag1
              - tag2
            type: docker
```