--- title: Product - GraphQL Admin description: >- The `Product` object lets you manage products in a merchant’s store. Products are the goods and services that merchants offer to customers. They can include various details such as title, description, price, images, and options such as size or color. You can use [product variants](https://shopify.dev/docs/api/admin-graphql/latest/objects/productvariant) to create or update different versions of the same product. You can also add or update product [media](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/media). Products can be organized by grouping them into a [collection](https://shopify.dev/docs/api/admin-graphql/latest/objects/collection). Learn more about working with [Shopify's product model](https://shopify.dev/docs/apps/build/graphql/migrate/new-product-model/product-model-components), including limitations and considerations. api_version: 2026-01 api_name: admin type: object api_type: graphql source_url: html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/Product' md: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/Product.md' --- # Product object Requires `read_products` access scope. The `Product` object lets you manage products in a merchant’s store. Products are the goods and services that merchants offer to customers. They can include various details such as title, description, price, images, and options such as size or color. You can use [product variants](https://shopify.dev/docs/api/admin-graphql/latest/objects/productvariant) to create or update different versions of the same product. You can also add or update product [media](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/media). Products can be organized by grouping them into a [collection](https://shopify.dev/docs/api/admin-graphql/latest/objects/collection). Learn more about working with [Shopify's product model](https://shopify.dev/docs/apps/build/graphql/migrate/new-product-model/product-model-components), including limitations and considerations. ## Fields * availablePublicationsCount * bundleComponents * bundleConsolidatedOptions * category * collections * combinedListing * combinedListingRole * compareAtPriceRange * contextualPricing * createdAt * defaultCursor * description * descriptionHtml * events * featuredMedia * feedback * giftCardTemplateSuffix * handle * hasOnlyDefaultVariant * hasOutOfStockVariants * hasVariantsThatRequiresComponents * id * inCollection * isGiftCard * legacyResourceId * media * mediaCount * metafield * metafields * onlineStorePreviewUrl * onlineStoreUrl * options * priceRangeV2 * productComponents * productComponentsCount * productParents * productType * publishedAt * publishedInContext * publishedOnCurrentPublication * publishedOnPublication * requiresSellingPlan * resourcePublicationOnCurrentPublication * resourcePublications * resourcePublicationsCount * resourcePublicationsV2 * restrictedForResource * sellingPlanGroups * sellingPlanGroupsCount * seo * status * tags * templateSuffix * title * totalInventory * tracksInventory * translations * unpublishedPublications * updatedAt * variants * variantsCount * vendor ### Deprecated fields * bodyHtml: deprecated * customProductType: deprecated * descriptionPlainSummary: deprecated * featuredImage: deprecated * images: deprecated * metafieldDefinitions: deprecated * priceRange: deprecated * productCategory: deprecated * productPublications: deprecated * publicationCount: deprecated * publications: deprecated * publishedOnChannel: deprecated * publishedOnCurrentChannel: deprecated * sellingPlanGroupCount: deprecated * standardizedProductType: deprecated * storefrontId: deprecated * totalVariants: deprecated * unpublishedChannels: deprecated *** ## Map ### Fields and connections with this object * [AbandonedCheckoutLineItem.product](https://shopify.dev/docs/api/admin-graphql/latest/objects/AbandonedCheckoutLineItem#field-AbandonedCheckoutLineItem.fields.product) * [CalculatedDraftOrderLineItem.product](https://shopify.dev/docs/api/admin-graphql/latest/objects/CalculatedDraftOrderLineItem#field-CalculatedDraftOrderLineItem.fields.product) * [Channel.products](https://shopify.dev/docs/api/admin-graphql/latest/objects/Channel#field-Channel.fields.products) * [Collection.products](https://shopify.dev/docs/api/admin-graphql/latest/objects/Collection#field-Collection.fields.products) * [CombinedListing.parentProduct](https://shopify.dev/docs/api/admin-graphql/latest/objects/CombinedListing#field-CombinedListing.fields.parentProduct) * [CombinedListingChild.product](https://shopify.dev/docs/api/admin-graphql/latest/objects/CombinedListingChild#field-CombinedListingChild.fields.product) * [CustomerVisitProductInfo.product](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerVisitProductInfo#field-CustomerVisitProductInfo.fields.product) * [DeliveryProfileItem.product](https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliveryProfileItem#field-DeliveryProfileItem.fields.product) * [DiscountProducts.products](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountProducts#field-DiscountProducts.fields.products) * [DraftOrderLineItem.product](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrderLineItem#field-DraftOrderLineItem.fields.product) * [LineItem.product](https://shopify.dev/docs/api/admin-graphql/latest/objects/LineItem#field-LineItem.fields.product) * [PriceRuleItemEntitlements.products](https://shopify.dev/docs/api/admin-graphql/latest/objects/PriceRuleItemEntitlements#field-PriceRuleItemEntitlements.fields.products) * [PriceRuleLineItemPrerequisites.products](https://shopify.dev/docs/api/admin-graphql/latest/objects/PriceRuleLineItemPrerequisites#field-PriceRuleLineItemPrerequisites.fields.products) * [Product.productParents](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product#field-Product.fields.productParents) * [ProductBundleComponent.componentProduct](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductBundleComponent#field-ProductBundleComponent.fields.componentProduct) * [ProductBundleOperation.product](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductBundleOperation#field-ProductBundleOperation.fields.product) * [ProductComponentType.product](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductComponentType#field-ProductComponentType.fields.product) * [ProductConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/ProductConnection#returns-nodes) * [ProductDeleteOperation.product](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductDeleteOperation#field-ProductDeleteOperation.fields.product) * [ProductDuplicateOperation.newProduct](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductDuplicateOperation#field-ProductDuplicateOperation.fields.newProduct) * [ProductDuplicateOperation.product](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductDuplicateOperation#field-ProductDuplicateOperation.fields.product) * [ProductEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductEdge#field-ProductEdge.fields.node) * [ProductOperation.product](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/ProductOperation#fields-product) * [ProductPublication.product](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductPublication#field-ProductPublication.fields.product) * [ProductSetOperation.product](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductSetOperation#field-ProductSetOperation.fields.product) * [ProductVariant.product](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant#field-ProductVariant.fields.product) * [ProductVariant.productParents](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant#field-ProductVariant.fields.productParents) * [Publication.includedProducts](https://shopify.dev/docs/api/admin-graphql/latest/objects/Publication#field-Publication.fields.includedProducts) * [Publication.products](https://shopify.dev/docs/api/admin-graphql/latest/objects/Publication#field-Publication.fields.products) * [SellingPlanGroup.products](https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlanGroup#field-SellingPlanGroup.fields.products) ### Possible type in * [Comment​Event​Embed](https://shopify.dev/docs/api/admin-graphql/latest/unions/CommentEventEmbed) * [Metafield​Reference](https://shopify.dev/docs/api/admin-graphql/latest/unions/MetafieldReference) * [Metafield​Referencer](https://shopify.dev/docs/api/admin-graphql/latest/unions/MetafieldReferencer) *** ## Queries * product * productByIdentifier * products * productByHandle: deprecated *** ## Product Queries ### Queried by * [product](https://shopify.dev/docs/api/admin-graphql/latest/queries/product) * [product​By​Identifier](https://shopify.dev/docs/api/admin-graphql/latest/queries/productByIdentifier) * [products](https://shopify.dev/docs/api/admin-graphql/latest/queries/products) *** ## Mutations * combinedListingUpdate * priceListFixedPricesByProductUpdate * productCreate * productDuplicate * productJoinSellingPlanGroups * productLeaveSellingPlanGroups * productOptionsCreate * productOptionsDelete * productOptionsReorder * productOptionUpdate * productSet * productUpdate * productVariantAppendMedia * productVariantDetachMedia * productVariantsBulkCreate * productVariantsBulkDelete * productVariantsBulkReorder * productVariantsBulkUpdate ### Deprecated mutations * productChangeStatus: deprecated * productCreateMedia: deprecated * productDeleteMedia: deprecated * productPublish: deprecated * productUnpublish: deprecated * productUpdateMedia: deprecated *** ## Product Mutations ### Mutated by * [combined​Listing​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/combinedListingUpdate) * [price​List​Fixed​Prices​By​Product​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/priceListFixedPricesByProductUpdate) * [product​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/productCreate) * [product​Duplicate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/productDuplicate) * [product​Join​Selling​Plan​Groups](https://shopify.dev/docs/api/admin-graphql/latest/mutations/productJoinSellingPlanGroups) * [product​Leave​Selling​Plan​Groups](https://shopify.dev/docs/api/admin-graphql/latest/mutations/productLeaveSellingPlanGroups) * [product​Option​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/productOptionUpdate) * [product​Options​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/productOptionsCreate) * [product​Options​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/productOptionsDelete) * [product​Options​Reorder](https://shopify.dev/docs/api/admin-graphql/latest/mutations/productOptionsReorder) * [product​Set](https://shopify.dev/docs/api/admin-graphql/latest/mutations/productSet) * [product​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/productUpdate) * [product​Variant​Append​Media](https://shopify.dev/docs/api/admin-graphql/latest/mutations/productVariantAppendMedia) * [product​Variant​Detach​Media](https://shopify.dev/docs/api/admin-graphql/latest/mutations/productVariantDetachMedia) * [product​Variants​Bulk​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/productVariantsBulkCreate) * [product​Variants​Bulk​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/productVariantsBulkDelete) * [product​Variants​Bulk​Reorder](https://shopify.dev/docs/api/admin-graphql/latest/mutations/productVariantsBulkReorder) * [product​Variants​Bulk​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/productVariantsBulkUpdate) *** ## Interfaces * HasEvents * HasMetafieldDefinitions * HasMetafields * HasPublishedTranslations * LegacyInteroperability * Navigable * Node * OnlineStorePreviewable * Publishable *** ## Product Implements ### Implements * [Has​Events](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasEvents) * [Has​Metafield​Definitions](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafieldDefinitions) * [Has​Metafields](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafields) * [Has​Published​Translations](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasPublishedTranslations) * [Legacy​Interoperability](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/LegacyInteroperability) * [Navigable](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Navigable) * [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node) * [Online​Store​Previewable](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/OnlineStorePreviewable) * [Publishable](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Publishable)