---
title: productByHandle - Storefront API
description: Find a product by its handle.
api_version: 2025-10
api_name: storefront
type: query
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/storefront/latest/queries/productbyhandle
  md: https://shopify.dev/docs/api/storefront/latest/queries/productbyhandle.md
---

# product​By​Handle

query

Deprecated. Use [product](https://shopify.dev/docs/api/admin-graphql/latest/queries/product) instead.

Find a product by its handle.

## Arguments

* handle

  [String!](https://shopify.dev/docs/api/storefront/latest/scalars/String)

  required

  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.

***

## Possible returns

* Product

  [Product](https://shopify.dev/docs/api/storefront/latest/objects/Product)

  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/storefront/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/storefront/latest/interfaces/Media). Products can be organized by grouping them into a [collection](https://shopify.dev/docs/api/storefront/latest/objects/Collection).

  Learn more about working with [products and collections](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/products-collections).

***

## Examples

* ### productByHandle reference

## Query Reference

```graphql
{
  productByHandle(handle) {
    # productByHandle fields
  }
}
```