---
title: CompanyLocation - GraphQL Admin
description: >-
  A location or branch of a
  [`Company`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Company)
  that's a customer of the shop. Company locations enable B2B customers to
  manage multiple branches with distinct billing and shipping addresses, tax
  settings, and checkout configurations.


  Each location can have its own
  [`Catalog`](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Catalog)
  objects that determine which products are published and their pricing. The
  [`BuyerExperienceConfiguration`](https://shopify.dev/docs/api/admin-graphql/latest/objects/BuyerExperienceConfiguration)
  determines checkout behavior including
  [`PaymentTerms`](https://shopify.dev/docs/api/admin-graphql/latest/objects/PaymentTerms),
  and whether orders require merchant review. B2B customers select which
  location they're purchasing for, which determines the applicable catalogs,
  pricing,
  [`TaxExemption`](https://shopify.dev/docs/api/admin-graphql/latest/enums/TaxExemption)
  values, and checkout settings for their
  [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order)
  objects.
api_version: 2026-01
api_name: admin
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyLocation'
  md: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyLocation.md'
---

# Company​Location

object

Requires `read_customers` access scope or `read_companies` access scope. Also: The API client must be installed on a Shopify Plus store.

A location or branch of a [`Company`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Company) that's a customer of the shop. Company locations enable B2B customers to manage multiple branches with distinct billing and shipping addresses, tax settings, and checkout configurations.

Each location can have its own [`Catalog`](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Catalog) objects that determine which products are published and their pricing. The [`BuyerExperienceConfiguration`](https://shopify.dev/docs/api/admin-graphql/latest/objects/BuyerExperienceConfiguration) determines checkout behavior including [`PaymentTerms`](https://shopify.dev/docs/api/admin-graphql/latest/objects/PaymentTerms), and whether orders require merchant review. B2B customers select which location they're purchasing for, which determines the applicable catalogs, pricing, [`TaxExemption`](https://shopify.dev/docs/api/admin-graphql/latest/enums/TaxExemption) values, and checkout settings for their [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order) objects.

## Fields

* billingAddress
* buyerExperienceConfiguration
* catalogs
* catalogsCount
* company
* createdAt
* currency
* defaultCursor
* draftOrders
* events
* externalId
* hasTimelineComment
* id
* inCatalog
* locale
* metafield
* metafields
* name
* note
* orders
* ordersCount
* phone
* roleAssignments
* shippingAddress
* staffMemberAssignments
* storeCreditAccounts
* taxSettings
* totalSpent
* updatedAt

### Deprecated fields

* market: deprecated
* metafieldDefinitions: deprecated
* orderCount: deprecated
* taxExemptions: deprecated
* taxRegistrationId: deprecated

***

## Map

### Fields and connections with this object

* [Company.locations](https://shopify.dev/docs/api/admin-graphql/latest/objects/Company#field-Company.fields.locations)
* [CompanyContactRoleAssignment.companyLocation](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyContactRoleAssignment#field-CompanyContactRoleAssignment.fields.companyLocation)
* [CompanyLocationCatalog.companyLocations](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyLocationCatalog#field-CompanyLocationCatalog.fields.companyLocations)
* [CompanyLocationConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/CompanyLocationConnection#returns-nodes)
* [CompanyLocationEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyLocationEdge#field-CompanyLocationEdge.fields.node)
* [CompanyLocationStaffMemberAssignment.companyLocation](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyLocationStaffMemberAssignment#field-CompanyLocationStaffMemberAssignment.fields.companyLocation)
* [CompanyLocationsCondition.companyLocations](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyLocationsCondition#field-CompanyLocationsCondition.fields.companyLocations)
* [PurchasingCompany.location](https://shopify.dev/docs/api/admin-graphql/latest/objects/PurchasingCompany#field-PurchasingCompany.fields.location)

### Possible type in

* [Metafield​Referencer](https://shopify.dev/docs/api/admin-graphql/latest/unions/MetafieldReferencer)

***

## Queries

* companyLocation
* companyLocations

***

## CompanyLocation Queries

### Queried by

* [company​Location](https://shopify.dev/docs/api/admin-graphql/latest/queries/companyLocation)
* [company​Locations](https://shopify.dev/docs/api/admin-graphql/latest/queries/companyLocations)

***

## Mutations

* companyLocationCreate
* companyLocationTaxSettingsUpdate
* companyLocationUpdate

### Deprecated mutations

* companyLocationAssignTaxExemptions: deprecated
* companyLocationCreateTaxRegistration: deprecated
* companyLocationRevokeTaxExemptions: deprecated
* companyLocationRevokeTaxRegistration: deprecated

***

## CompanyLocation Mutations

### Mutated by

* [company​Location​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyLocationCreate)
* [company​Location​Tax​Settings​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyLocationTaxSettingsUpdate)
* [company​Location​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/companyLocationUpdate)

***

## Interfaces

* CommentEventSubject
* HasEvents
* HasMetafieldDefinitions
* HasMetafields
* HasStoreCreditAccounts
* Navigable
* Node

***

## CompanyLocation Implements

### Implements

* [Comment​Event​Subject](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/CommentEventSubject)
* [Has​Events](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasEvents)
* [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)
* [Has​Store​Credit​Accounts](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasStoreCreditAccounts)
* [Navigable](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Navigable)
* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)