# collectionByHandle - storefront - QUERY
Version: 2025-04

## Description
Find a collection by its handle.

### Access Scopes



## Arguments
* [handle](/docs/api/storefront/2025-04/scalars/String): String! - The handle of the collection.


## Returns
* [description](/docs/api/storefront/2025-04/scalars/String): String! Stripped description of the collection, single line with HTML tags removed.
* [descriptionHtml](/docs/api/storefront/2025-04/scalars/HTML): HTML! The description of the collection, complete with HTML formatting.
* [handle](/docs/api/storefront/2025-04/scalars/String): String! A human-friendly unique string for the collection automatically generated from its title.
Limit of 255 characters.

* [id](/docs/api/storefront/2025-04/scalars/ID): ID! A globally-unique ID.
* [image](/docs/api/storefront/2025-04/objects/Image): Image Image associated with the collection.
* [metafield](/docs/api/storefront/2025-04/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/2025-04/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/2025-04/scalars/URL): URL The URL used for viewing the resource on the shop's Online Store. Returns `null` if the resource is currently not published to the Online Store sales channel.
* [seo](/docs/api/storefront/2025-04/objects/SEO): SEO! The collection's SEO information.
* [title](/docs/api/storefront/2025-04/scalars/String): String! The collection’s name. Limit of 255 characters.
* [trackingParameters](/docs/api/storefront/2025-04/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/2025-04/scalars/DateTime): DateTime! The date and time when the collection was last modified.


## Examples