---
title: CompanyLocation - Storefront API
description: |-
  A branch or office of a
  [`Company`](/docs/api/storefront/2026-07/objects/Company)
  where B2B customers can place orders. When a B2B customer selects a location
  after logging in, the Storefront API contextualizes product queries to return
  location-specific pricing and quantity rules.

  Access through the [`PurchasingCompany`](/docs/api/storefront/2026-07/objects/PurchasingCompany)
  object, which associates the location with the buyer's
  [`Cart`](/docs/api/storefront/2026-07/objects/Cart).
api_version: 2026-07
source_url:
  html: https://shopify.dev/docs/api/storefront/latest/objects/companylocation
  md: https://shopify.dev/docs/api/storefront/latest/objects/companylocation.md
---

# Company​Location

object

A branch or office of a [`Company`](https://shopify.dev/docs/api/storefront/2026-07/objects/Company) where B2B customers can place orders. When a B2B customer selects a location after logging in, the Storefront API contextualizes product queries to return location-specific pricing and quantity rules.

Access through the [`PurchasingCompany`](https://shopify.dev/docs/api/storefront/2026-07/objects/PurchasingCompany) object, which associates the location with the buyer's [`Cart`](https://shopify.dev/docs/api/storefront/2026-07/objects/Cart).

## Fields

* created​At

  [Date​Time!](https://shopify.dev/docs/api/storefront/latest/scalars/DateTime)

  non-null

  The date and time ([ISO 8601 format](http://en.wikipedia.org/wiki/ISO_8601)) at which the company location was created in Shopify.

* external​Id

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

  A unique externally-supplied ID for the company.

* id

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

  non-null

  A globally-unique ID.

* locale

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

  The preferred locale of the company location.

* 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 company location.

* updated​At

  [Date​Time!](https://shopify.dev/docs/api/storefront/latest/scalars/DateTime)

  non-null

  The date and time ([ISO 8601 format](http://en.wikipedia.org/wiki/ISO_8601)) at which the company location was last modified.

***

## Map

### Fields with this object

* [PurchasingCompany.location](https://shopify.dev/docs/api/storefront/latest/objects/PurchasingCompany#field-PurchasingCompany.fields.location)

### Possible type in

* [Metafield​Parent​Resource](https://shopify.dev/docs/api/storefront/latest/unions/MetafieldParentResource)

***

## Interfaces

* * [Has​Metafields](https://shopify.dev/docs/api/storefront/latest/interfaces/HasMetafields)

    interface

  * [Node](https://shopify.dev/docs/api/storefront/latest/interfaces/Node)

    interface

***

## CompanyLocation Implements

### Implements

* [Has​Metafields](https://shopify.dev/docs/api/storefront/latest/interfaces/HasMetafields)
* [Node](https://shopify.dev/docs/api/storefront/latest/interfaces/Node)