---
title: DiscountBulkTagsAddPayload - GraphQL Admin
description: Return type for `discountBulkTagsAdd` mutation.
api_version: 2026-04
api_name: admin
type: payload
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/payloads/DiscountBulkTagsAddPayload
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/payloads/DiscountBulkTagsAddPayload.md
---

# Discount​Bulk​Tags​Add​Payload

payload

Return type for `discountBulkTagsAdd` mutation.

## Fields

* job

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

  The asynchronous job that adds the tags.

* user​Errors

  [\[Discount​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Mutations with this payload

* [discount​Bulk​Tags​Add](https://shopify.dev/docs/api/admin-graphql/latest/mutations/discountBulkTagsAdd)

  mutation

  Adds tags to multiple [discounts](https://help.shopify.com/manual/discounts/discount-types) asynchronously using one of the following:

  * A search query
  * A saved search ID
  * A list of discount IDs

  For example, you can add tags to price rules that match a search criteria, or add tags to a predefined set of price rules.

  * search

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

    ### Arguments

    The search query for filtering discounts.\
    \
    For more information on the list of supported fields and search syntax, refer to the [`discountNodes`](https://shopify.dev/docs/api/admin-graphql/latest/queries/discountNodes#query-arguments) query.

  * saved​Search​Id

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

    The ID of the saved search for filtering discounts to tag.

  * ids

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

    The IDs of the discounts to tag.

  * tags

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

    required

    The tags to add to the discounts.

  ***

***

## Map

### Mutations with this payload

* [discount​Bulk​Tags​Add](https://shopify.dev/docs/api/admin-graphql/latest/mutations/discountBulkTagsAdd)