Product
Requires access scope.
Error codes for failed mutation.
Anchor to FieldsFields
- Anchor to codecode•Product
Options Delete User Error Code The error code.
- Anchor to fieldfield•[String!]
The path to the input field that caused the error.
- Anchor to messagemessage•String!non-null
The error message.
Anchor to MutationsMutations
- •mutation
Deletes one or more options from a product. Product options define the choices available for a product, such as size, color, or material.
CautionUse the
mutation for the following use cases:- Simplify product configuration: Remove obsolete or unnecessary options (for example, discontinue "Material" if all variants are now the same material).
- Clean up after seasonal or limited-time offerings: Delete options that are no longer relevant (for example, "Holiday edition").
- Automate catalog management: Enable apps or integrations to programmatically remove options as product data changes.
NoteThe
mutation enforces strict data integrity for product options and variants. All option positions must remain sequential, and every remaining option must be used by at least one variant.After you delete a product option, you can further manage a product's configuration using related mutations:
Learn more about the product model and adding product data.
- Anchor to optionsoptions•[ID!]!required
IDs of the options to delete from the product.
- Anchor to productIdproduct•ID!
Id required ID of the product from which to delete the options.
- Anchor to strategystrategy•Product
Option Delete Strategy Default:DEFAULT The strategy defines which behavior the mutation should observe,such as how to handle a situation where deleting an option would result in duplicate variants.
Arguments
- Anchor to deletedOptionsIdsdeleted•[ID!]
Options Ids IDs of the options deleted.
- Anchor to productproduct•Product
The updated product object.
- Anchor to userErrorsuser•[Product
Errors Options Delete User Error!]! non-null The list of errors that occurred from executing the mutation.
Fields