---
title: menu - Storefront API
description: >
  Retrieves a [`Menu`](/docs/api/storefront/2026-01/objects/Menu) by its handle.
  Menus are [hierarchical navigation
  structures](https://help.shopify.com/manual/online-store/menus-and-links) that
  merchants configure for their storefront, such as header and footer
  navigation.


  Each menu contains [`MenuItem`](/docs/api/storefront/2026-01/objects/MenuItem)
  objects that can nest up to three levels deep, with each item linking to
  [collections](/docs/api/storefront/2026-01/objects/Collection),
  [products](/docs/api/storefront/2026-01/objects/Product),
  [pages](/docs/api/storefront/2026-01/objects/Page),
  [blogs](/docs/api/storefront/2026-01/objects/Blog), or external URLs.
api_version: 2026-01
api_name: storefront
type: query
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/storefront/latest/queries/menu'
  md: 'https://shopify.dev/docs/api/storefront/latest/queries/menu.md'
---

# menu

query

Retrieves a [`Menu`](https://shopify.dev/docs/api/storefront/2026-01/objects/Menu) by its handle. Menus are [hierarchical navigation structures](https://help.shopify.com/manual/online-store/menus-and-links) that merchants configure for their storefront, such as header and footer navigation.

Each menu contains [`MenuItem`](https://shopify.dev/docs/api/storefront/2026-01/objects/MenuItem) objects that can nest up to three levels deep, with each item linking to [collections](https://shopify.dev/docs/api/storefront/2026-01/objects/Collection), [products](https://shopify.dev/docs/api/storefront/2026-01/objects/Product), [pages](https://shopify.dev/docs/api/storefront/2026-01/objects/Page), [blogs](https://shopify.dev/docs/api/storefront/2026-01/objects/Blog), or external URLs.

## Arguments

* handle

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

  required

  The navigation menu's handle.

***

## Possible returns

* Menu

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

  A navigation structure for building store [menus](https://help.shopify.com/manual/online-store/menus-and-links). Each menu contains [`MenuItem`](https://shopify.dev/docs/api/storefront/2026-01/objects/MenuItem) objects that can be nested to create multi-level navigation hierarchies.

  Menu items can link to [collections](https://shopify.dev/docs/api/storefront/2026-01/objects/Collection), [products](https://shopify.dev/docs/api/storefront/2026-01/objects/Product), [pages](https://shopify.dev/docs/api/storefront/2026-01/objects/Page), [blogs](https://shopify.dev/docs/api/storefront/2026-01/objects/Blog), or external URLs. Use the [`menu`](https://shopify.dev/docs/api/storefront/2026-01/queries/menu) query to retrieve a menu by its handle.

  * handle

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

    non-null Token access required

    The menu's handle.

  * id

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

    non-null Token access required

    A globally-unique ID.

  * items

    [\[Menu​Item!\]!](https://shopify.dev/docs/api/storefront/latest/objects/MenuItem)

    non-null Token access required

    The menu's child items.

  * items​Count

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

    non-null Token access required

    The count of items on the menu.

  * title

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

    non-null Token access required

    The menu's title.

***

## Examples

* ### menu reference