--- title: Location - GraphQL Admin description: >- A physical location where merchants store and fulfill inventory. Locations include retail stores, warehouses, popups, dropshippers, or other places where inventory is managed or stocked. Active locations can fulfill online orders when configured with shipping rates, local pickup, or local delivery options. Locations track inventory quantities for [products](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) and process [order](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order) fulfillment. Third-party apps using [`FulfillmentService`](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentService) can create and manage their own locations. api_version: 2026-01 api_name: admin type: object api_type: graphql source_url: html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/Location' md: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/Location.md' --- # Location object Requires `read_locations` access scope, `read_inventory` access scope or `read_markets_home` access scope. A physical location where merchants store and fulfill inventory. Locations include retail stores, warehouses, popups, dropshippers, or other places where inventory is managed or stocked. Active locations can fulfill online orders when configured with shipping rates, local pickup, or local delivery options. Locations track inventory quantities for [products](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) and process [order](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order) fulfillment. Third-party apps using [`FulfillmentService`](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentService) can create and manage their own locations. ## Fields * activatable * address * addressVerified * createdAt * deactivatable * deactivatedAt * deletable * fulfillmentService * fulfillsOnlineOrders * hasActiveInventory * hasUnfulfilledOrders * id * inventoryLevel * inventoryLevels * isActive * isFulfillmentService * legacyResourceId * localPickupSettingsV2 * metafield * metafields * name * shipsInventory * suggestedAddresses * updatedAt ### Deprecated fields * isPrimary: deprecated * metafieldDefinitions: deprecated *** ## Map ### Fields and connections with this object * [CashTrackingSession.location](https://shopify.dev/docs/api/admin-graphql/latest/objects/CashTrackingSession#field-CashTrackingSession.fields.location) * [CustomerEmailAddress.sourceLocation](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerEmailAddress#field-CustomerEmailAddress.fields.sourceLocation) * [CustomerEmailMarketingConsentState.sourceLocation](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerEmailMarketingConsentState#field-CustomerEmailMarketingConsentState.fields.sourceLocation) * [CustomerPhoneNumber.sourceLocation](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerPhoneNumber#field-CustomerPhoneNumber.fields.sourceLocation) * [CustomerSmsMarketingConsentState.sourceLocation](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerSmsMarketingConsentState#field-CustomerSmsMarketingConsentState.fields.sourceLocation) * [DeliveryCarrierServiceAndLocations.locations](https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliveryCarrierServiceAndLocations#field-DeliveryCarrierServiceAndLocations.fields.locations) * [DeliveryLocationGroup.locations](https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliveryLocationGroup#field-DeliveryLocationGroup.fields.locations) * [DeliveryProfile.unassignedLocations](https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliveryProfile#field-DeliveryProfile.fields.unassignedLocations) * [DeliveryProfile.unassignedLocationsPaginated](https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliveryProfile#field-DeliveryProfile.fields.unassignedLocationsPaginated) * [DeliveryPromiseProvider.location](https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliveryPromiseProvider#field-DeliveryPromiseProvider.fields.location) * [Fulfillment.location](https://shopify.dev/docs/api/admin-graphql/latest/objects/Fulfillment#field-Fulfillment.fields.location) * [FulfillmentOrderAssignedLocation.location](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentOrderAssignedLocation#field-FulfillmentOrderAssignedLocation.fields.location) * [FulfillmentOrderDestination.location](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentOrderDestination#field-FulfillmentOrderDestination.fields.location) * [FulfillmentOrderLocationForMove.location](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentOrderLocationForMove#field-FulfillmentOrderLocationForMove.fields.location) * [FulfillmentService.location](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentService#field-FulfillmentService.fields.location) * [InventoryChange.location](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryChange#field-InventoryChange.fields.location) * [InventoryLevel.location](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryLevel#field-InventoryLevel.fields.location) * [LocationConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/LocationConnection#returns-nodes) * [LocationEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/LocationEdge#field-LocationEdge.fields.node) * [LocationSnapshot.location](https://shopify.dev/docs/api/admin-graphql/latest/objects/LocationSnapshot#field-LocationSnapshot.fields.location) * [LocationsCondition.locations](https://shopify.dev/docs/api/admin-graphql/latest/objects/LocationsCondition#field-LocationsCondition.fields.locations) * [Order.retailLocation](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order#field-Order.fields.retailLocation) * [OrderTransaction.location](https://shopify.dev/docs/api/admin-graphql/latest/objects/OrderTransaction#field-OrderTransaction.fields.location) * [RefundLineItem.location](https://shopify.dev/docs/api/admin-graphql/latest/objects/RefundLineItem#field-RefundLineItem.fields.location) * [ReverseFulfillmentOrderDisposition.location](https://shopify.dev/docs/api/admin-graphql/latest/objects/ReverseFulfillmentOrderDisposition#field-ReverseFulfillmentOrderDisposition.fields.location) * [SubscriptionDeliveryMethodPickupOption.location](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionDeliveryMethodPickupOption#field-SubscriptionDeliveryMethodPickupOption.fields.location) * [SubscriptionPickupOption.location](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionPickupOption#field-SubscriptionPickupOption.fields.location) ### Possible type in * [Metafield​Referencer](https://shopify.dev/docs/api/admin-graphql/latest/unions/MetafieldReferencer) *** ## Queries * location * locationByIdentifier * locations * locationsAvailableForDeliveryProfilesConnection * locationsAvailableForDeliveryProfiles: deprecated *** ## Location Queries ### Queried by * [location](https://shopify.dev/docs/api/admin-graphql/latest/queries/location) * [location​By​Identifier](https://shopify.dev/docs/api/admin-graphql/latest/queries/locationByIdentifier) * [locations](https://shopify.dev/docs/api/admin-graphql/latest/queries/locations) * [locations​Available​For​Delivery​Profiles​Connection](https://shopify.dev/docs/api/admin-graphql/latest/queries/locationsAvailableForDeliveryProfilesConnection) *** ## Mutations * locationActivate * locationAdd * locationDeactivate * locationEdit *** ## Location Mutations ### Mutated by * [location​Activate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/locationActivate) * [location​Add](https://shopify.dev/docs/api/admin-graphql/latest/mutations/locationAdd) * [location​Deactivate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/locationDeactivate) * [location​Edit](https://shopify.dev/docs/api/admin-graphql/latest/mutations/locationEdit) *** ## Interfaces * HasMetafieldDefinitions * HasMetafields * LegacyInteroperability * Node *** ## Location Implements ### Implements * [Has​Metafield​Definitions](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafieldDefinitions) * [Has​Metafields](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafields) * [Legacy​Interoperability](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/LegacyInteroperability) * [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)