---
title: GiftCardProductSetUserErrorCode - GraphQL Admin
description: Possible error codes that can be returned by `GiftCardProductSetUserError`.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/enums/GiftCardProductSetUserErrorCode
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/enums/GiftCardProductSetUserErrorCode.md
api_name: admin
api_type: graphql
type: enum
---

# Gift​Card​Product​Set​User​Error​Code

enum

Possible error codes that can be returned by `GiftCardProductSetUserError`.

## Valid values

* BARCODE\_​CHECKSUM\_​VALIDATION\_​FAILED

  Barcode checksum validation failed.

* BARCODE\_​VALUE\_​TOO\_​LONG

  Barcode value is too long.

* BLANK\_​BARCODE\_​VALUE

  Barcode value cannot be blank.

* CANNOT\_​COMBINE\_​LINKED\_​AND\_​NONLINKED\_​OPTION\_​VALUES

  An option cannot have both metafield linked and nonlinked option values.

* CAPABILITY\_​VIOLATION

  The metafield violates a capability restriction.

* DUPLICATE\_​BARCODE\_​VALUE

  Duplicate barcode value within the same variant.

* DUPLICATE\_​LINKED\_​OPTION

  Cannot link multiple options to the same metafield.

* DUPLICATED\_​METAFIELD\_​VALUE

  Duplicated metafield value for linked option.

* DUPLICATED\_​OPTION\_​NAME

  Duplicated option name.

* DUPLICATED\_​OPTION\_​VALUE

  Duplicated option value.

* DUPLICATED\_​VALUE

  Duplicated value.

* GENERIC\_​ERROR

  Something went wrong, please try again.

* GIFT\_​CARD\_​ATTRIBUTE\_​CANNOT\_​BE\_​CHANGED

  The product gift\_card attribute cannot be changed after creation.

* GIFT\_​CARDS\_​NOT\_​ACTIVATED

  Gift card products can only be created after they have been activated.

* HANDLE\_​NOT\_​UNIQUE

  Handle already in use. Please provide a new handle.

* ID\_​NOT\_​ALLOWED

  The id field is not allowed if identifier is provided.

* INCOMPATIBLE\_​BARCODE\_​FIELDS

  Cannot provide both 'barcode' and 'barcodes' for the same variant.

* INPUT\_​MISMATCH

  The identifier value does not match the value of the corresponding field in the input.

* INVALID\_​BARCODE\_​CHARACTERS

  Barcode value contains invalid characters for its type.

* INVALID\_​BARCODE\_​LENGTH

  Barcode value has an invalid length for its type.

* INVALID\_​BARCODE\_​PREFIX

  Barcode value has an invalid prefix for its type.

* INVALID\_​BARCODE\_​SEPARATORS

  Barcode value contains invalid spaces or hyphens for its type.

* INVALID\_​BARCODE\_​TYPE

  Barcode type is not supported. Allowed barcode types are: upc, ean, isbn, gtin, asin, ns-pid.

* INVALID\_​INPUT

  Input is not valid.

* INVALID\_​METAFIELD

  Metafield is not valid.

* INVALID\_​METAFIELD\_​VALUE\_​FOR\_​LINKED\_​OPTION

  Invalid metafield value for linked option.

* INVALID\_​PRODUCT

  Product is not valid.

* INVALID\_​VARIANT

  Product variant is not valid.

* JOB\_​ERROR

  Error processing request in the background job.

* LINKED\_​METAFIELD\_​DEFINITION\_​NOT\_​FOUND

  No valid metafield definition found for linked option.

* LINKED\_​OPTIONS\_​NOT\_​SUPPORTED\_​FOR\_​SHOP

  Linked options are currently not supported for this shop.

* METAFIELD\_​MISMATCH

  The input argument `metafields` (if present) must contain the `customId` value.

* MISSING\_​FIELD\_​REQUIRED

  The input field corresponding to the identifier is required.

* NOT\_​FOUND

  Resource matching the identifier was not found.

* OPTION\_​DOES\_​NOT\_​EXIST

  Option does not exist.

* OPTION\_​VALUE\_​DOES\_​NOT\_​EXIST

  Option value does not exist.

* OPTION\_​VALUES\_​MISSING

  Each option must have at least one option value specified.

* OPTION\_​VALUES\_​OVER\_​LIMIT

  Option values over limit.

* OPTIONS\_​OVER\_​LIMIT

  Options over limit.

* PRODUCT\_​DOES\_​NOT\_​EXIST

  Product does not exist.

* PRODUCT\_​MUST\_​BE\_​GIFT\_​CARD

  The specified product is not a gift card. The giftCardProductSet mutation can only be used with gift card products.

* PRODUCT\_​OPTIONS\_​INPUT\_​MISSING

  Must specify product options when updating variants.

* PRODUCT\_​SUSPENDED

  Product is suspended.

* PRODUCT\_​VARIANT\_​DOES\_​NOT\_​EXIST

  Product variant does not exist.

* TOO\_​MANY\_​BARCODES

  Can only specify a maximum of 20 barcodes per variant.

* VARIANTS\_​INPUT\_​MISSING

  Must specify variants when updating options.

* VARIANTS\_​OVER\_​LIMIT

  Number of product variants exceeds shop limit.

***

## Fields

* [Gift​Card​Product​Set​User​Error.code](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCardProductSetUserError#field-GiftCardProductSetUserError.fields.code)

  OBJECT

  Defines errors for GiftCardProductSet mutation.

***

## Map

### Fields with this enum

* [Gift​Card​Product​Set​User​Error.code](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCardProductSetUserError#field-GiftCardProductSetUserError.fields.code)