---
title: menu - Storefront API
description: >-
  Retrieves a [`Menu`](/docs/api/storefront/2026-10/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-10/objects/MenuItem)

  objects that can nest up to three levels deep, with each item linking to
  [collections](/docs/api/storefront/2026-10/objects/Collection),

  [products](/docs/api/storefront/2026-10/objects/Product),

  [pages](/docs/api/storefront/2026-10/objects/Page),

  [blogs](/docs/api/storefront/2026-10/objects/Blog), or external URLs.
api_version: 2026-10
source_url:
  html: 'https://shopify.dev/docs/api/storefront/latest/queries/menu'
  md: 'https://shopify.dev/docs/api/storefront/latest/queries/menu.md'
api_name: storefront
api_type: graphql
type: query
---

# menu

query

Retrieves a [`Menu`](https://shopify.dev/docs/api/storefront/2026-10/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-10/objects/MenuItem) objects that can nest up to three levels deep, with each item linking to [collections](https://shopify.dev/docs/api/storefront/2026-10/objects/Collection), [products](https://shopify.dev/docs/api/storefront/2026-10/objects/Product), [pages](https://shopify.dev/docs/api/storefront/2026-10/objects/Page), [blogs](https://shopify.dev/docs/api/storefront/2026-10/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-10/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-10/objects/Collection), [products](https://shopify.dev/docs/api/storefront/2026-10/objects/Product), [pages](https://shopify.dev/docs/api/storefront/2026-10/objects/Page), [blogs](https://shopify.dev/docs/api/storefront/2026-10/objects/Blog), or external URLs. Use the [`menu`](https://shopify.dev/docs/api/storefront/2026-10/queries/menu) query to retrieve a menu by its handle.

  * handle

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

    non-null

    The menu's handle.

  * id

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

    non-null

    A globally-unique ID.

  * items

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

    non-null

    The menu's child items.

  * items​Count

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

    non-null

    The count of items on the menu.

  * title

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

    non-null

    The menu's title.

***

## Examples

* ### menu reference