The goods and services that merchants offer to customers. Products can include details such as title, vendor, and custom data stored in metafields. Products can be organized by grouping them into a collection.
Learn more about managing products in a merchant's store.
Handle!)
A unique, human-readable string of the product's title. A handle can contain letters, hyphens (-), and
numbers, but not spaces. The handle is used in the online store URL for the product. For example, if a product
is titled "Black Sunglasses", then the handle is black-sunglasses.
Boolean!)
Whether the product is associated with any of the specified tags. The product must have at least one tag
from the list to return true.
| Argument | Description |
|---|---|
tags
(
[String!]!
)
required
|
A comma-separated list of searchable keywords that are associated with the product. For example,
|
[HasTagResponse!]!)
Whether the product is associated with the specified tags. The product must have all of the tags in the list
to return true.
| Argument | Description |
|---|---|
tags
(
[String!]!
)
required
|
A comma-separated list of searchable keywords that are associated with the product. For example,
|
ID!)
A globally-unique ID for the product.
Boolean!)
Whether the product is in any of the specified collections. The product must be in at least one collection
from the list to return true.
A collection is a group of products that can be displayed in online stores and other sales channels in categories, which makes it easy for customers to find them. For example, an athletics store might create different collections for running attire and accessories.
| Argument | Description |
|---|---|
ids
(
[ID!]!
)
required
|
A comma-separated list of globally-unique collection IDs
that are associated with the product. For example, |
[CollectionMembership!]!)
Whether the product is in the specified collections. The product must be in all of the collections in the
list to return true.
A collection is a group of products that can be displayed in online stores and other sales channels in categories, which makes it easy for customers to find them. For example, an athletics store might create different collections for running attire and accessories.
| Argument | Description |
|---|---|
ids
(
[ID!]!
)
required
|
A comma-separated list of globally-unique collection IDs
that are associated with the product. For example, |
Boolean!)
Whether the product is a gift card.
Metafield)
A custom field that stores additional information about a Shopify resource, such as products, orders, and many more. Using metafields with Shopify Functions enables you to customize the checkout experience.
| Argument | Description |
|---|---|
key
(
String!
)
required
|
The unique identifier for the metafield within its namespace. A metafield is composed of a
namespace and a key, in the format |
namespace
(
String
)
|
A category that organizes a group of metafields. Namespaces are used to prevent naming conflicts between different apps or different parts of the same app. If omitted, then the app-reserved namespace is used. |
String)
A custom category for a product. Product types allow merchants to define categories other than the ones available in Shopify's standard product categories.
String!)
The localized name for the product that displays to customers. The title is used to construct the product's
handle, which is a unique, human-readable string of the product's title. For example, if a product is titled
"Black Sunglasses", then the handle is black-sunglasses.
String)
The name of the product's vendor.
[GateSubject!]!)
deprecated
Returns active gate subjects bound to the resource.
Gates API is being sunset and will be removed in a future version. Use metafields instead for gate configuration.
| Argument | Description |
|---|---|
handle
(
Handle
)
|
The handle of the gate configurations to search for. |