---
title: Location
description: Subscribe to field-level changes on the Location GraphQL Admin API object.
api_version: 2026-10
source_url:
  html: 'https://shopify.dev/docs/api/events/latest/location'
  md: 'https://shopify.dev/docs/api/events/latest/location.md'
api_name: events
---

# Location

**Requires `read_locations` access scope.:**

Supported [actions](https://shopify.dev/docs/apps/build/events/subscribe#actions): `create`, `update`, `delete`

Subscribe to field-level changes on the [`Location`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Location) GraphQL Admin API object.

Each [topic](https://shopify.dev/docs/api/events/latest#configuration) corresponds to a commerce resource that can exist independently within its domain. Child entities that depend on a parent within the same domain don't have their own topic. Instead, changes to child entities trigger a delivery on the parent topic. Calculated fields, derived fields, auto-updated timestamps, and cross-domain fields aren't available as triggers.

## shopify.app.toml

```toml
[events]
api_version = "2026-10"


[[events.subscription]]
handle = "my_location_event"


topic = "Location"
actions = ["update"]
triggers = ["location.address.*"]


uri = "https://your-app.com/events"


query = """
query location_event_payload($locationId: ID!) {
  location(id: $locationId) {
    id
    name
    isActive
    address {
      __typename
    }
  }
}
"""
```

***

## Supported triggers

Field-level [triggers](https://shopify.dev/docs/api/events/latest#configuration) for `Location` subscriptions.

All triggers require the `read_locations` access scope. Those triggers that require additional scopes are documented where relevant. Deprecated triggers are listed last.

Subscriptions can include multiple triggers. Use the `shopify-webhook-id` header for deduplication when handling duplicate deliveries.

Custom queries aren't limited to [`Location`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Location). They can query the full GraphQL Admin API.

### location​.\*[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Location)

Fires when events involve the [`Location`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Location) object.

The `"create"` and `"delete"` actions are only relevant within the context of this parent topic. Use `fields_changed` to follow or replicate impacted data after a delete event. Define a custom query to retrieve specific fields from create events.

`location.*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `location`, including nested triggers. Use a more specific trigger to limit events to the fields you need.

**Variables:** `locationId`

### location​.address​.\*[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Location#field-Location.fields.address)

Fires when the [`address`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Location#field-Location.fields.address) field on the [`Location`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Location) object changes.

`location.address.*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `location.address`, including nested triggers. Use a more specific trigger to limit events to the fields you need.

Include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

The `address` field represents the address of this location.

**Variables:** `locationId`

### location​.address​.address1[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/LocationAddress#field-LocationAddress.fields.address1)

Fires when the [`address1`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/LocationAddress#field-LocationAddress.fields.address1) field on the [`LocationAddress`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/LocationAddress) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

The `address1` field represents the first line of the address for the location.

**Variables:** `locationId`

### location​.address​.address2[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/LocationAddress#field-LocationAddress.fields.address2)

Fires when the [`address2`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/LocationAddress#field-LocationAddress.fields.address2) field on the [`LocationAddress`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/LocationAddress) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

The `address2` field represents the second line of the address for the location.

**Variables:** `locationId`

### location​.address​.city[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/LocationAddress#field-LocationAddress.fields.city)

Fires when the [`city`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/LocationAddress#field-LocationAddress.fields.city) field on the [`LocationAddress`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/LocationAddress) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

The `city` field represents the city of the location.

**Variables:** `locationId`

### location​.address​.countryCode[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/LocationAddress#field-LocationAddress.fields.countryCode)

Fires when the [`countryCode`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/LocationAddress#field-LocationAddress.fields.countryCode) field on the [`LocationAddress`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/LocationAddress) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

The `countryCode` field represents the country code of the location.

**Variables:** `locationId`

### location​.address​.latitude[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/LocationAddress#field-LocationAddress.fields.latitude)

Fires when the [`latitude`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/LocationAddress#field-LocationAddress.fields.latitude) field on the [`LocationAddress`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/LocationAddress) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

The `latitude` field represents the approximate latitude coordinates of the location.

**Variables:** `locationId`

### location​.address​.longitude[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/LocationAddress#field-LocationAddress.fields.longitude)

Fires when the [`longitude`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/LocationAddress#field-LocationAddress.fields.longitude) field on the [`LocationAddress`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/LocationAddress) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

The `longitude` field represents the approximate longitude coordinates of the location.

**Variables:** `locationId`

### location​.address​.phone[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/LocationAddress#field-LocationAddress.fields.phone)

Fires when the [`phone`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/LocationAddress#field-LocationAddress.fields.phone) field on the [`LocationAddress`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/LocationAddress) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

The `phone` field represents the phone number of the location.

**Variables:** `locationId`

### location​.address​.provinceCode[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/LocationAddress#field-LocationAddress.fields.provinceCode)

Fires when the [`provinceCode`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/LocationAddress#field-LocationAddress.fields.provinceCode) field on the [`LocationAddress`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/LocationAddress) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

The `provinceCode` field represents the code for the province, state, or district of the address of the location.

**Variables:** `locationId`

### location​.address​.zip[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/LocationAddress#field-LocationAddress.fields.zip)

Fires when the [`zip`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/LocationAddress#field-LocationAddress.fields.zip) field on the [`LocationAddress`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/LocationAddress) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

The `zip` field represents the ZIP code of the location.

**Variables:** `locationId`

### location​.deactivatedAt[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Location#field-Location.fields.deactivatedAt)

Fires when the [`deactivatedAt`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Location#field-Location.fields.deactivatedAt) field on the [`Location`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Location) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

The `deactivatedAt` field represents the date and time (ISO 8601 format) that the location was deactivated at.

**Variables:** `locationId`

### location​.fulfillsOnlineOrders[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Location#field-Location.fields.fulfillsOnlineOrders)

Fires when the [`fulfillsOnlineOrders`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Location#field-Location.fields.fulfillsOnlineOrders) field on the [`Location`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Location) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

The `fulfillsOnlineOrders` field indicates whether this location can fulfill online orders.

**Variables:** `locationId`

### location​.isActive[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Location#field-Location.fields.isActive)

Fires when the [`isActive`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Location#field-Location.fields.isActive) field on the [`Location`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Location) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

The `isActive` field indicates whether the location is active.

**Variables:** `locationId`

### location​.metafield(namespace: String!, key: String!)​.\*[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Location#field-Location.fields.metafield)

Fires when the [`metafield`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Location#field-Location.fields.metafield) field on the [`Location`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Location) object changes.

`location.metafield(namespace: String!, key: String!).*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `location.metafield(namespace: String!, key: String!)`, including nested triggers. Use a more specific trigger to limit events to the fields you need.

Include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

The `metafield` field represents a custom field, including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information.

**Variables:** `locationId`, `metafieldKey`, `metafieldNamespace`

### location​.metafield(namespace: String!)​.\*[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Location#field-Location.fields.metafield)

Fires when the [`metafield`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Location#field-Location.fields.metafield) field on the [`Location`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Location) object changes.

`location.metafield(namespace: String!).*` is a parent trigger. Subscribing with the `"update"` action receives events for all supported triggers under `location.metafield(namespace: String!)`, including nested triggers. Use a more specific trigger to limit events to the fields you need.

Include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

This subscription omits the optional argument `metafield.key`.

The `metafield` field represents a custom field, including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information.

**Variables:** `locationId`, `metafieldKey`, `metafieldNamespace`

### location​.metafield(namespace: String!, key: String!)​.value[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Metafield#field-Metafield.fields.value)

Fires when the [`value`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Metafield#field-Metafield.fields.value) field on the [`Metafield`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Metafield) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

The `value` field represents the data stored in the metafield.

**Variables:** `locationId`, `metafieldKey`, `metafieldNamespace`

### location​.metafield(namespace: String!)​.value[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Metafield#field-Metafield.fields.value)

Fires when the [`value`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Metafield#field-Metafield.fields.value) field on the [`Metafield`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Metafield) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

This subscription omits the optional argument `metafield.key`.

The `value` field represents the data stored in the metafield.

**Variables:** `locationId`, `metafieldKey`, `metafieldNamespace`

### location​.shipsInventory[](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Location#field-Location.fields.shipsInventory)

Fires when the [`shipsInventory`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Location#field-Location.fields.shipsInventory) field on the [`Location`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/Location) object changes.

Subscribe to this trigger with the `"update"` action and include the field in a custom `query` to retrieve updated data from the payload. You can trace the field in subsequent requests using `fields_changed`.

Legacy field indicating this location was designated for shipping.

**Variables:** `locationId`

### Examples

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

  [[events.subscription]]
  handle = "location-event"

  topic = "Location"
  actions = ["create","update","delete"]
  triggers = ["location.*"]

  uri = "https://your-app.com/events"

  query = """
  query location_details($locationId: ID!) {
    location(id: $locationId) {
      id
      name
      isActive
    }
  }
  """
  ```

  ##### Payload (added)

  ```json
  {
    "topic": "Location",
    "action": "create",
    "handle": "location-event",
    "data": {
      "location": {
        "id": "gid://shopify/Location/6305469131566",
        "name": "Example location",
        "isActive": true
      }
    },
    "fields_changed": {
      "added": [
        "location[id: 'gid://shopify/Location/6305469131566']"
      ],
      "updated": [],
      "removed": []
    },
    "query_variables": {
      "locationId": "gid://shopify/Location/6305469131566"
    }
  }
  ```

  ##### Payload (updated)

  ```json
  {
    "topic": "Location",
    "action": "update",
    "handle": "location-event",
    "data": {
      "location": {
        "id": "gid://shopify/Location/6305469131566",
        "name": "Example location",
        "isActive": true
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "location[id: 'gid://shopify/Location/6305469131566'].address.address1"
      ],
      "removed": []
    },
    "query_variables": {
      "locationId": "gid://shopify/Location/6305469131566"
    }
  }
  ```

  ##### Payload (removed)

  ```json
  {
    "topic": "Location",
    "action": "delete",
    "handle": "location-event",
    "data": {
      "location": null
    },
    "fields_changed": {
      "added": [],
      "updated": [],
      "removed": [
        "location[id: 'gid://shopify/Location/6305469131566']"
      ]
    },
    "query_variables": {
      "locationId": "gid://shopify/Location/6305469131566"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update # or create, delete
  shopify-api-version: 2026-10
  shopify-handle: location-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Location
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

  [[events.subscription]]
  handle = "location-event"

  topic = "Location"
  actions = ["update"]
  triggers = ["location.address.*"]

  uri = "https://your-app.com/events"

  query = """
  query location_event_payload($locationId: ID!) {
    location(id: $locationId) {
      id
      name
      isActive
      address {
        __typename
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Location",
    "action": "update",
    "handle": "location-event",
    "data": {
      "location": {
        "id": "gid://shopify/Location/6305469131566",
        "name": "Example location",
        "isActive": true,
        "address": {
          "__typename": "LocationAddress"
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "location[id: 'gid://shopify/Location/6305469131566'].address.address1"
      ],
      "removed": []
    },
    "query_variables": {
      "locationId": "gid://shopify/Location/6305469131566"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: 2026-10
  shopify-handle: location-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Location
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

  [[events.subscription]]
  handle = "location-event"

  topic = "Location"
  actions = ["update"]
  triggers = ["location.address.address1"]

  uri = "https://your-app.com/events"

  query = """
  query location_event_payload($locationId: ID!) {
    location(id: $locationId) {
      id
      name
      isActive
      address {
        address1
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Location",
    "action": "update",
    "handle": "location-event",
    "data": {
      "location": {
        "id": "gid://shopify/Location/6305469131566",
        "name": "Example location",
        "isActive": true,
        "address": {
          "address1": "…"
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "location[id: 'gid://shopify/Location/6305469131566'].address.address1"
      ],
      "removed": []
    },
    "query_variables": {
      "locationId": "gid://shopify/Location/6305469131566"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: 2026-10
  shopify-handle: location-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Location
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

  [[events.subscription]]
  handle = "location-event"

  topic = "Location"
  actions = ["update"]
  triggers = ["location.address.address2"]

  uri = "https://your-app.com/events"

  query = """
  query location_event_payload($locationId: ID!) {
    location(id: $locationId) {
      id
      name
      isActive
      address {
        address2
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Location",
    "action": "update",
    "handle": "location-event",
    "data": {
      "location": {
        "id": "gid://shopify/Location/6305469131566",
        "name": "Example location",
        "isActive": true,
        "address": {
          "address2": "…"
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "location[id: 'gid://shopify/Location/6305469131566'].address.address2"
      ],
      "removed": []
    },
    "query_variables": {
      "locationId": "gid://shopify/Location/6305469131566"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: 2026-10
  shopify-handle: location-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Location
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

  [[events.subscription]]
  handle = "location-event"

  topic = "Location"
  actions = ["update"]
  triggers = ["location.address.city"]

  uri = "https://your-app.com/events"

  query = """
  query location_event_payload($locationId: ID!) {
    location(id: $locationId) {
      id
      name
      isActive
      address {
        city
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Location",
    "action": "update",
    "handle": "location-event",
    "data": {
      "location": {
        "id": "gid://shopify/Location/6305469131566",
        "name": "Example location",
        "isActive": true,
        "address": {
          "city": "…"
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "location[id: 'gid://shopify/Location/6305469131566'].address.city"
      ],
      "removed": []
    },
    "query_variables": {
      "locationId": "gid://shopify/Location/6305469131566"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: 2026-10
  shopify-handle: location-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Location
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

  [[events.subscription]]
  handle = "location-event"

  topic = "Location"
  actions = ["update"]
  triggers = ["location.address.countryCode"]

  uri = "https://your-app.com/events"

  query = """
  query location_event_payload($locationId: ID!) {
    location(id: $locationId) {
      id
      name
      isActive
      address {
        countryCode
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Location",
    "action": "update",
    "handle": "location-event",
    "data": {
      "location": {
        "id": "gid://shopify/Location/6305469131566",
        "name": "Example location",
        "isActive": true,
        "address": {
          "countryCode": "…"
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "location[id: 'gid://shopify/Location/6305469131566'].address.countryCode"
      ],
      "removed": []
    },
    "query_variables": {
      "locationId": "gid://shopify/Location/6305469131566"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: 2026-10
  shopify-handle: location-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Location
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

  [[events.subscription]]
  handle = "location-event"

  topic = "Location"
  actions = ["update"]
  triggers = ["location.address.latitude"]

  uri = "https://your-app.com/events"

  query = """
  query location_event_payload($locationId: ID!) {
    location(id: $locationId) {
      id
      name
      isActive
      address {
        latitude
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Location",
    "action": "update",
    "handle": "location-event",
    "data": {
      "location": {
        "id": "gid://shopify/Location/6305469131566",
        "name": "Example location",
        "isActive": true,
        "address": {
          "latitude": "…"
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "location[id: 'gid://shopify/Location/6305469131566'].address.latitude"
      ],
      "removed": []
    },
    "query_variables": {
      "locationId": "gid://shopify/Location/6305469131566"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: 2026-10
  shopify-handle: location-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Location
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

  [[events.subscription]]
  handle = "location-event"

  topic = "Location"
  actions = ["update"]
  triggers = ["location.address.longitude"]

  uri = "https://your-app.com/events"

  query = """
  query location_event_payload($locationId: ID!) {
    location(id: $locationId) {
      id
      name
      isActive
      address {
        longitude
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Location",
    "action": "update",
    "handle": "location-event",
    "data": {
      "location": {
        "id": "gid://shopify/Location/6305469131566",
        "name": "Example location",
        "isActive": true,
        "address": {
          "longitude": "…"
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "location[id: 'gid://shopify/Location/6305469131566'].address.longitude"
      ],
      "removed": []
    },
    "query_variables": {
      "locationId": "gid://shopify/Location/6305469131566"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: 2026-10
  shopify-handle: location-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Location
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

  [[events.subscription]]
  handle = "location-event"

  topic = "Location"
  actions = ["update"]
  triggers = ["location.address.phone"]

  uri = "https://your-app.com/events"

  query = """
  query location_event_payload($locationId: ID!) {
    location(id: $locationId) {
      id
      name
      isActive
      address {
        phone
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Location",
    "action": "update",
    "handle": "location-event",
    "data": {
      "location": {
        "id": "gid://shopify/Location/6305469131566",
        "name": "Example location",
        "isActive": true,
        "address": {
          "phone": "…"
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "location[id: 'gid://shopify/Location/6305469131566'].address.phone"
      ],
      "removed": []
    },
    "query_variables": {
      "locationId": "gid://shopify/Location/6305469131566"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: 2026-10
  shopify-handle: location-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Location
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

  [[events.subscription]]
  handle = "location-event"

  topic = "Location"
  actions = ["update"]
  triggers = ["location.address.provinceCode"]

  uri = "https://your-app.com/events"

  query = """
  query location_event_payload($locationId: ID!) {
    location(id: $locationId) {
      id
      name
      isActive
      address {
        provinceCode
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Location",
    "action": "update",
    "handle": "location-event",
    "data": {
      "location": {
        "id": "gid://shopify/Location/6305469131566",
        "name": "Example location",
        "isActive": true,
        "address": {
          "provinceCode": "…"
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "location[id: 'gid://shopify/Location/6305469131566'].address.provinceCode"
      ],
      "removed": []
    },
    "query_variables": {
      "locationId": "gid://shopify/Location/6305469131566"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: 2026-10
  shopify-handle: location-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Location
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

  [[events.subscription]]
  handle = "location-event"

  topic = "Location"
  actions = ["update"]
  triggers = ["location.address.zip"]

  uri = "https://your-app.com/events"

  query = """
  query location_event_payload($locationId: ID!) {
    location(id: $locationId) {
      id
      name
      isActive
      address {
        zip
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Location",
    "action": "update",
    "handle": "location-event",
    "data": {
      "location": {
        "id": "gid://shopify/Location/6305469131566",
        "name": "Example location",
        "isActive": true,
        "address": {
          "zip": "…"
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "location[id: 'gid://shopify/Location/6305469131566'].address.zip"
      ],
      "removed": []
    },
    "query_variables": {
      "locationId": "gid://shopify/Location/6305469131566"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: 2026-10
  shopify-handle: location-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Location
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

  [[events.subscription]]
  handle = "location-event"

  topic = "Location"
  actions = ["update"]
  triggers = ["location.deactivatedAt"]

  uri = "https://your-app.com/events"

  query = """
  query location_event_payload($locationId: ID!) {
    location(id: $locationId) {
      id
      name
      isActive
      deactivatedAt
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Location",
    "action": "update",
    "handle": "location-event",
    "data": {
      "location": {
        "id": "gid://shopify/Location/6305469131566",
        "name": "Example location",
        "isActive": true,
        "deactivatedAt": "…"
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "location[id: 'gid://shopify/Location/6305469131566'].deactivatedAt"
      ],
      "removed": []
    },
    "query_variables": {
      "locationId": "gid://shopify/Location/6305469131566"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: 2026-10
  shopify-handle: location-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Location
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

  [[events.subscription]]
  handle = "location-event"

  topic = "Location"
  actions = ["update"]
  triggers = ["location.fulfillsOnlineOrders"]

  uri = "https://your-app.com/events"

  query = """
  query location_event_payload($locationId: ID!) {
    location(id: $locationId) {
      id
      name
      isActive
      fulfillsOnlineOrders
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Location",
    "action": "update",
    "handle": "location-event",
    "data": {
      "location": {
        "id": "gid://shopify/Location/6305469131566",
        "name": "Example location",
        "isActive": true,
        "fulfillsOnlineOrders": "…"
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "location[id: 'gid://shopify/Location/6305469131566'].fulfillsOnlineOrders"
      ],
      "removed": []
    },
    "query_variables": {
      "locationId": "gid://shopify/Location/6305469131566"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: 2026-10
  shopify-handle: location-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Location
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

  [[events.subscription]]
  handle = "location-event"

  topic = "Location"
  actions = ["update"]
  triggers = ["location.isActive"]

  uri = "https://your-app.com/events"

  query = """
  query location_event_payload($locationId: ID!) {
    location(id: $locationId) {
      id
      name
      isActive
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Location",
    "action": "update",
    "handle": "location-event",
    "data": {
      "location": {
        "id": "gid://shopify/Location/6305469131566",
        "name": "Example location",
        "isActive": true
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "location[id: 'gid://shopify/Location/6305469131566'].isActive"
      ],
      "removed": []
    },
    "query_variables": {
      "locationId": "gid://shopify/Location/6305469131566"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: 2026-10
  shopify-handle: location-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Location
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

  [[events.subscription]]
  handle = "location-event"

  topic = "Location"
  actions = ["update"]
  triggers = ["location.metafield(namespace: 'custom', key: 'rating').*"]

  uri = "https://your-app.com/events"

  query = """
  query location_event_payload($locationId: ID!, $metafieldNamespace: String!, $metafieldKey: String!) {
    location(id: $locationId) {
      id
      name
      isActive
      metafield(namespace: $metafieldNamespace, key: $metafieldKey) {
        namespace
        key
        value
        type
      }
    }
  }
  """
  ```

  ##### Payload (added)

  ```json
  {
    "topic": "Location",
    "action": "update",
    "handle": "location-event",
    "data": {
      "location": {
        "id": "gid://shopify/Location/6305469131566",
        "name": "Example location",
        "isActive": true,
        "metafield": {
          "namespace": "custom",
          "key": "rating",
          "value": "Cotton",
          "type": "single_line_text_field"
        }
      }
    },
    "fields_changed": {
      "added": [
        "location[id: 'gid://shopify/Location/6305469131566'].metafield[namespace: 'custom', key: 'rating']"
      ],
      "updated": [],
      "removed": []
    },
    "query_variables": {
      "locationId": "gid://shopify/Location/6305469131566",
      "metafieldKey": "rating",
      "metafieldNamespace": "custom"
    }
  }
  ```

  ##### Payload (removed)

  ```json
  {
    "topic": "Location",
    "action": "update",
    "handle": "location-event",
    "data": {
      "location": {
        "id": "gid://shopify/Location/6305469131566",
        "name": "Example location",
        "isActive": true,
        "metafield": {
          "namespace": "custom",
          "key": "rating",
          "value": "Cotton",
          "type": "single_line_text_field"
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [],
      "removed": [
        "location[id: 'gid://shopify/Location/6305469131566'].metafield[namespace: 'custom', key: 'rating']"
      ]
    },
    "query_variables": {
      "locationId": "gid://shopify/Location/6305469131566",
      "metafieldKey": "rating",
      "metafieldNamespace": "custom"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: 2026-10
  shopify-handle: location-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Location
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

  [[events.subscription]]
  handle = "location-event"

  topic = "Location"
  actions = ["update"]
  triggers = ["location.metafield(namespace: 'custom').*"]

  uri = "https://your-app.com/events"

  query = """
  query location_event_payload($locationId: ID!, $metafieldNamespace: String!, $metafieldKey: String!) {
    location(id: $locationId) {
      id
      name
      isActive
      metafield(namespace: $metafieldNamespace, key: $metafieldKey) {
        namespace
        key
        value
        type
      }
    }
  }
  """
  ```

  ##### Payload (added)

  ```json
  {
    "topic": "Location",
    "action": "update",
    "handle": "location-event",
    "data": {
      "location": {
        "id": "gid://shopify/Location/6305469131566",
        "name": "Example location",
        "isActive": true,
        "metafield": {
          "namespace": "custom",
          "key": "rating",
          "value": "Cotton",
          "type": "single_line_text_field"
        }
      }
    },
    "fields_changed": {
      "added": [
        "location[id: 'gid://shopify/Location/6305469131566'].metafield[namespace: 'custom', key: 'rating']"
      ],
      "updated": [],
      "removed": []
    },
    "query_variables": {
      "locationId": "gid://shopify/Location/6305469131566",
      "metafieldKey": "rating",
      "metafieldNamespace": "custom"
    }
  }
  ```

  ##### Payload (removed)

  ```json
  {
    "topic": "Location",
    "action": "update",
    "handle": "location-event",
    "data": {
      "location": {
        "id": "gid://shopify/Location/6305469131566",
        "name": "Example location",
        "isActive": true,
        "metafield": {
          "namespace": "custom",
          "key": "rating",
          "value": "Cotton",
          "type": "single_line_text_field"
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [],
      "removed": [
        "location[id: 'gid://shopify/Location/6305469131566'].metafield[namespace: 'custom', key: 'rating']"
      ]
    },
    "query_variables": {
      "locationId": "gid://shopify/Location/6305469131566",
      "metafieldKey": "rating",
      "metafieldNamespace": "custom"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: 2026-10
  shopify-handle: location-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Location
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

  [[events.subscription]]
  handle = "location-event"

  topic = "Location"
  actions = ["update"]
  triggers = ["location.metafield(namespace: 'custom', key: 'rating').value"]

  uri = "https://your-app.com/events"

  query = """
  query location_event_payload($locationId: ID!, $metafieldNamespace: String!, $metafieldKey: String!) {
    location(id: $locationId) {
      id
      name
      isActive
      metafield(namespace: $metafieldNamespace, key: $metafieldKey) {
        namespace
        key
        value
        type
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Location",
    "action": "update",
    "handle": "location-event",
    "data": {
      "location": {
        "id": "gid://shopify/Location/6305469131566",
        "name": "Example location",
        "isActive": true,
        "metafield": {
          "namespace": "custom",
          "key": "rating",
          "value": "Cotton",
          "type": "single_line_text_field"
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "location[id: 'gid://shopify/Location/6305469131566'].metafield[namespace: 'custom', key: 'rating'].value"
      ],
      "removed": []
    },
    "query_variables": {
      "locationId": "gid://shopify/Location/6305469131566",
      "metafieldKey": "rating",
      "metafieldNamespace": "custom"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: 2026-10
  shopify-handle: location-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Location
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

  [[events.subscription]]
  handle = "location-event"

  topic = "Location"
  actions = ["update"]
  triggers = ["location.metafield(namespace: 'custom').value"]

  uri = "https://your-app.com/events"

  query = """
  query location_event_payload($locationId: ID!, $metafieldNamespace: String!, $metafieldKey: String!) {
    location(id: $locationId) {
      id
      name
      isActive
      metafield(namespace: $metafieldNamespace, key: $metafieldKey) {
        namespace
        key
        value
        type
      }
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Location",
    "action": "update",
    "handle": "location-event",
    "data": {
      "location": {
        "id": "gid://shopify/Location/6305469131566",
        "name": "Example location",
        "isActive": true,
        "metafield": {
          "namespace": "custom",
          "key": "rating",
          "value": "Cotton",
          "type": "single_line_text_field"
        }
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "location[id: 'gid://shopify/Location/6305469131566'].metafield[namespace: 'custom', key: 'rating'].value"
      ],
      "removed": []
    },
    "query_variables": {
      "locationId": "gid://shopify/Location/6305469131566",
      "metafieldKey": "rating",
      "metafieldNamespace": "custom"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: 2026-10
  shopify-handle: location-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Location
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

* #### Subscribe via app configuration

  ##### shopify.app.toml

  ```toml
  [events]
  api_version = "2026-10"

  [[events.subscription]]
  handle = "location-event"

  topic = "Location"
  actions = ["update"]
  triggers = ["location.shipsInventory"]

  uri = "https://your-app.com/events"

  query = """
  query location_event_payload($locationId: ID!) {
    location(id: $locationId) {
      id
      name
      isActive
      shipsInventory
    }
  }
  """
  ```

  ##### Payload

  ```json
  {
    "topic": "Location",
    "action": "update",
    "handle": "location-event",
    "data": {
      "location": {
        "id": "gid://shopify/Location/6305469131566",
        "name": "Example location",
        "isActive": true,
        "shipsInventory": "…"
      }
    },
    "fields_changed": {
      "added": [],
      "updated": [
        "location[id: 'gid://shopify/Location/6305469131566'].shipsInventory"
      ],
      "removed": []
    },
    "query_variables": {
      "locationId": "gid://shopify/Location/6305469131566"
    }
  }
  ```

  ##### Headers

  ```bash
  shopify-action: update
  shopify-api-version: 2026-10
  shopify-handle: location-event
  shopify-hmac-sha256: 61lWIGuA2nXdHRjhMU/+EDw2y3Eg0mPKJ+RhR7dKKIM=
  shopify-shop-domain: your-shop.myshopify.com
  shopify-topic: Location
  shopify-triggered-at: 2026-03-23T16:24:35.267Z
  shopify-webhook-id: 7613956a-18a5-332d-b71e-e164bbcacdba
  ```

***