--- title: Location - Storefront API description: >- A physical store location where product inventory is held and that supports in-store pickup. Provides the location's name, address, and geographic coordinates for proximity-based sorting. Use with [`StoreAvailability`](/docs/api/storefront/2026-07/objects/StoreAvailability) to show customers where a [`ProductVariant`](/docs/api/storefront/2026-07/objects/ProductVariant) is available for pickup. Learn more about [supporting local pickup on storefronts](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/products-collections/local-pickup). api_version: 2026-07 source_url: html: 'https://shopify.dev/docs/api/storefront/latest/objects/Location' md: 'https://shopify.dev/docs/api/storefront/latest/objects/Location.md' api_name: storefront api_type: graphql type: object --- # Location object Requires `unauthenticated_read_product_pickup_locations` access scope. A physical store location where product inventory is held and that supports in-store pickup. Provides the location's name, address, and geographic coordinates for proximity-based sorting. Use with [`StoreAvailability`](https://shopify.dev/docs/api/storefront/2026-07/objects/StoreAvailability) to show customers where a [`ProductVariant`](https://shopify.dev/docs/api/storefront/2026-07/objects/ProductVariant) is available for pickup. Learn more about [supporting local pickup on storefronts](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/products-collections/local-pickup). ## Fields * address [Location​Address!](https://shopify.dev/docs/api/storefront/latest/objects/LocationAddress) non-null The address of the location. * id [ID!](https://shopify.dev/docs/api/storefront/latest/scalars/ID) non-null A globally-unique ID. * metafield [Metafield](https://shopify.dev/docs/api/storefront/latest/objects/Metafield) Token access required 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. * key [String!](https://shopify.dev/docs/api/storefront/latest/scalars/String) required ### Arguments The identifier for the metafield. * namespace [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) The container the metafield belongs to. If omitted, the app-reserved namespace will be used. *** * metafields [\[Metafield\]!](https://shopify.dev/docs/api/storefront/latest/objects/Metafield) non-null Token access required A list of [custom fields](https://shopify.dev/docs/apps/build/custom-data) that a merchant associates with a Shopify resource. * identifiers [\[Has​Metafields​Identifier!\]!](https://shopify.dev/docs/api/storefront/latest/input-objects/HasMetafieldsIdentifier) required ### Arguments The list of metafields to retrieve by namespace and key. The input must not contain more than `250` values. *** * name [String!](https://shopify.dev/docs/api/storefront/latest/scalars/String) non-null The name of the location. *** ## Map ### Fields and connections with this object * [LocationConnection.nodes](https://shopify.dev/docs/api/storefront/latest/connections/LocationConnection#returns-nodes) * [LocationEdge.node](https://shopify.dev/docs/api/storefront/latest/objects/LocationEdge#field-LocationEdge.fields.node) * [StoreAvailability.location](https://shopify.dev/docs/api/storefront/latest/objects/StoreAvailability#field-StoreAvailability.fields.location) ### Possible type in * [Metafield​Parent​Resource](https://shopify.dev/docs/api/storefront/latest/unions/MetafieldParentResource) *** ## Queries * [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-07/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-07/queries/locations#arguments-sortKey.enums.DISTANCE) and provide coordinates using the [`near`](https://shopify.dev/docs/api/storefront/2026-07/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). * after [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) ### Arguments Returns the elements that come after the specified cursor. * before [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) Returns the elements that come before the specified cursor. * first [Int](https://shopify.dev/docs/api/storefront/latest/scalars/Int) Returns up to the first `n` elements from the list. * last [Int](https://shopify.dev/docs/api/storefront/latest/scalars/Int) Returns up to the last `n` elements from the list. * 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. * 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. *** *** ## Location Queries ### Queried by * [locations](https://shopify.dev/docs/api/storefront/latest/queries/locations) *** ## Interfaces * * [Has​Metafields](https://shopify.dev/docs/api/storefront/latest/interfaces/HasMetafields) interface * [Node](https://shopify.dev/docs/api/storefront/latest/interfaces/Node) interface *** ## Location Implements ### Implements * [Has​Metafields](https://shopify.dev/docs/api/storefront/latest/interfaces/HasMetafields) * [Node](https://shopify.dev/docs/api/storefront/latest/interfaces/Node)