---
title: draftOrderBulkAddTags - GraphQL Admin
description: Adds tags to multiple draft orders.
api_version: 2024-10
api_name: admin
type: mutation
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/draftOrderBulkAddTags
  md: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/draftOrderBulkAddTags.txt
---

# draft​Order​Bulk​Add​Tags

mutation

Requires `write_draft_orders` access scope. Also: The user must have access to manage draft orders.

Adds tags to multiple draft orders.

## Arguments

* ids

  [\[ID!\]](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/ID)

  The IDs of the draft orders to add tags to.

* saved​Search​Id

  [ID](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/ID)

  The ID of the draft order saved search for filtering draft orders on.

* search

  [String](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/String)

  The conditions for filtering draft orders on. See the detailed [search syntax](https://shopify.dev/api/usage/search-syntax).

* tags

  [\[String!\]!](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/String)

  required

  List of tags to be added.

***

## Draft​Order​Bulk​Add​Tags​Payload returns

* job

  [Job](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/Job)

  The asynchronous job for adding tags to the draft orders.

* user​Errors

  [\[User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/UserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### draftOrderBulkAddTags reference

## Mutation Reference

```graphql
mutation draftOrderBulkAddTags($search: String, $savedSearchId: ID, $ids: [ID!], $tags: [String!]!) {
  draftOrderBulkAddTags(search: $search, savedSearchId: $savedSearchId, ids: $ids, tags: $tags) {
    job {
      # Job fields
    }
    userErrors {
      field
      message
    }
  }
}
```

## Input

```json
{
  "search": "<your-search>",
  "savedSearchId": "gid://shopify/<objectName>/10079785100",
  "ids": [
    "gid://shopify/<objectName>/10079785100"
  ],
  "tags": [
    "<your-tags>"
  ]
}
```