---
title: collectionByHandle - Storefront API
description: Find a collection 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/collectionByHandle
  md: https://shopify.dev/docs/api/storefront/latest/queries/collectionByHandle.md
---

# collection​By​Handle

query

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

Find a collection by its handle.

## Arguments

* handle

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

  required

  The handle of the collection.

***

## Possible returns

* Collection

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

  A collection represents a grouping of products that a shop owner can create to organize them or make their shops easier to browse.

***

## Examples

* ### collectionByHandle reference

## Query Reference

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