---
title: LocationConnection - Storefront API
description: |
  An auto-generated type for paginating through multiple Locations.
api_version: 2026-01
api_name: storefront
type: connection
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/storefront/latest/connections/LocationConnection
  md: https://shopify.dev/docs/api/storefront/latest/connections/LocationConnection.md
---

# Location​Connection

connection

An auto-generated type for paginating through multiple Locations.

## Queries with this connection

* [locations](https://shopify.dev/docs/api/storefront/latest/queries/locations)

  query

  Returns shop locations that support in-store pickup. Use the `near` argument with [`GeoCoordinateInput`](https://shopify.dev/docs/api/storefront/2026-01/input-objects/GeoCoordinateInput) to sort results by proximity to the customer's location.

  When sorting by distance, set `sortKey` to [`DISTANCE`](https://shopify.dev/docs/api/storefront/2026-01/queries/locations#arguments-sortKey.enums.DISTANCE) and provide coordinates using the [`near`](https://shopify.dev/docs/api/storefront/2026-01/queries/locations#arguments-near) argument.

  Learn more about [supporting local pickup on storefronts](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/products-collections/local-pickup).

  * first

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

    ### Arguments

    Returns up to the first `n` elements from the list.

  * after

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

    Returns the elements that come after the specified cursor.

  * last

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

    Returns up to the last `n` elements from the list.

  * before

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

    Returns the elements that come before the specified cursor.

  * reverse

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

    Default:false

    Reverse the order of the underlying list.

  * sort​Key

    [Location​Sort​Keys](https://shopify.dev/docs/api/storefront/latest/enums/LocationSortKeys)

    Default:ID

    Sort the underlying list by the given key.

  * near

    [Geo​Coordinate​Input](https://shopify.dev/docs/api/storefront/latest/input-objects/GeoCoordinateInput)

    Used to sort results based on proximity to the provided location.

  ***

***

## Possible returns

* edges

  [\[Location​Edge!\]!](https://shopify.dev/docs/api/storefront/latest/objects/LocationEdge)

  non-null

  A list of edges.

* nodes

  [\[Location!\]!](https://shopify.dev/docs/api/storefront/latest/objects/Location)

  non-null

  A list of the nodes contained in LocationEdge.

* page​Info

  [Page​Info!](https://shopify.dev/docs/api/storefront/latest/objects/PageInfo)

  non-null

  Information to aid in pagination.

***

## Map

### Queries with this connection

* [locations](https://shopify.dev/docs/api/storefront/latest/queries/locations)

### Possible returns

* [Location​Connection.edges](https://shopify.dev/docs/api/storefront/latest/connections/LocationConnection#returns-edges)
* [Location​Connection.nodes](https://shopify.dev/docs/api/storefront/latest/connections/LocationConnection#returns-nodes)
* [Location​Connection.pageInfo](https://shopify.dev/docs/api/storefront/latest/connections/LocationConnection#returns-pageInfo)