# productByHandle - storefront - QUERY
Version: 2024-07
## Description
Find a product by its handle.
### Access Scopes
## Arguments
* [handle](/docs/api/storefront/2024-07/scalars/String): String! - A unique, human-readable string of the product's title.
A handle can contain letters, hyphens (`-`), and numbers, but no spaces.
The handle is used in the online store URL for the product.
## Returns
* [availableForSale](/docs/api/storefront/2024-07/scalars/Boolean): Boolean! Indicates if at least one product variant is available for sale.
* [compareAtPriceRange](/docs/api/storefront/2024-07/objects/ProductPriceRange): ProductPriceRange! The [compare-at price range](https://help.shopify.com/manual/products/details/product-pricing/sale-pricing) of the product in the shop's default currency.
* [createdAt](/docs/api/storefront/2024-07/scalars/DateTime): DateTime! The date and time when the product was created.
* [description](/docs/api/storefront/2024-07/scalars/String): String! A single-line description of the product, with [HTML tags](https://developer.mozilla.org/en-US/docs/Web/HTML) removed.
* [descriptionHtml](/docs/api/storefront/2024-07/scalars/HTML): HTML! The description of the product, with
HTML tags. For example, the description might include
bold `` and italic `` text.
* [featuredImage](/docs/api/storefront/2024-07/objects/Image): Image The featured image for the product.
This field is functionally equivalent to `images(first: 1)`.
* [handle](/docs/api/storefront/2024-07/scalars/String): String! A unique, human-readable string of the product's title.
A handle can contain letters, hyphens (`-`), and numbers, but no spaces.
The handle is used in the online store URL for the product.
* [id](/docs/api/storefront/2024-07/scalars/ID): ID! A globally-unique ID.
* [isGiftCard](/docs/api/storefront/2024-07/scalars/Boolean): Boolean! Whether the product is a gift card.
* [metafield](/docs/api/storefront/2024-07/objects/Metafield): Metafield A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information.
* [metafields](/docs/api/storefront/2024-07/objects/Metafield): Metafield! A list of [custom fields](/docs/apps/build/custom-data) that a merchant associates with a Shopify resource.
* [onlineStoreUrl](/docs/api/storefront/2024-07/scalars/URL): URL The product's URL on the online store.
If `null`, then the product isn't published to the online store sales channel.
* [options](/docs/api/storefront/2024-07/objects/ProductOption): ProductOption! A list of product options. The limit is defined by the [shop's resource limits for product options](/docs/api/admin-graphql/latest/objects/Shop#field-resourcelimits) (`Shop.resourceLimits.maxProductOptions`).
* [priceRange](/docs/api/storefront/2024-07/objects/ProductPriceRange): ProductPriceRange! The minimum and maximum prices of a product, expressed in decimal numbers.
For example, if the product is priced between $10.00 and $50.00,
then the price range is $10.00 - $50.00.
* [productType](/docs/api/storefront/2024-07/scalars/String): String! The [product type](https://help.shopify.com/manual/products/details/product-type)
that merchants define.
* [publishedAt](/docs/api/storefront/2024-07/scalars/DateTime): DateTime! The date and time when the product was published to the channel.
* [requiresSellingPlan](/docs/api/storefront/2024-07/scalars/Boolean): Boolean! Whether the product can only be purchased with a [selling plan](/docs/apps/build/purchase-options/subscriptions/selling-plans). Products that are sold on subscription (`requiresSellingPlan: true`) can be updated only for online stores. If you update a product to be subscription-only (`requiresSellingPlan:false`), then the product is unpublished from all channels, except the online store.
* [seo](/docs/api/storefront/2024-07/objects/SEO): SEO! The [SEO title and description](https://help.shopify.com/manual/promoting-marketing/seo/adding-keywords)
that are associated with a product.
* [tags](/docs/api/storefront/2024-07/scalars/String): String! A comma-separated list of searchable keywords that are
associated with the product. For example, a merchant might apply the `sports`
and `summer` tags to products that are associated with sportwear for summer.
Updating `tags` overwrites any existing tags that were previously added to the product.
To add new tags without overwriting existing tags,
use the GraphQL Admin API's [`tagsAdd`](/docs/api/admin-graphql/latest/mutations/tagsadd)
mutation.
* [title](/docs/api/storefront/2024-07/scalars/String): String! The name for the product that displays to customers. The title is used to construct the product's handle.
For example, if a product is titled "Black Sunglasses", then the handle is `black-sunglasses`.
* [totalInventory](/docs/api/storefront/2024-07/scalars/Int): Int The quantity of inventory that's in stock.
* [trackingParameters](/docs/api/storefront/2024-07/scalars/String): String URL parameters to be added to a page URL to track the origin of on-site search traffic for [analytics reporting](https://help.shopify.com/manual/reports-and-analytics/shopify-reports/report-types/default-reports/behaviour-reports). Returns a result when accessed through the [search](https://shopify.dev/docs/api/storefront/current/queries/search) or [predictiveSearch](https://shopify.dev/docs/api/storefront/current/queries/predictiveSearch) queries, otherwise returns null.
* [updatedAt](/docs/api/storefront/2024-07/scalars/DateTime): DateTime! The date and time when the product was last modified.
A product's `updatedAt` value can change for different reasons. For example, if an order
is placed for a product that has inventory tracking set up, then the inventory adjustment
is counted as an update.
* [variantBySelectedOptions](/docs/api/storefront/2024-07/objects/ProductVariant): ProductVariant Find a product’s variant based on its selected options.
This is useful for converting a user’s selection of product options into a single matching variant.
If there is not a variant for the selected options, `null` will be returned.
* [vendor](/docs/api/storefront/2024-07/scalars/String): String! The name of the product's vendor.
## Examples