---
title: collectionByHandle - Storefront API
description: Find a collection by its handle.
api_version: unstable
api_name: storefront
source_url:
  html: 'https://shopify.dev/docs/api/storefront/unstable/queries/collectionByHandle'
  md: >-
    https://shopify.dev/docs/api/storefront/unstable/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/unstable/scalars/String)

  required

  The handle of the collection.

***

## Possible returns

* Collection

  [Collection](https://shopify.dev/docs/api/storefront/unstable/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
  }
}
```