# CompanyLocation - admin - OBJECT
Version: 2025-01

## Description
A location or branch of a [company that's a customer](https://shopify.dev/api/admin-graphql/latest/objects/company) of the shop. Configuration of B2B relationship, for example prices lists and checkout settings, may be done for a location.

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


## Fields
* [billingAddress](/docs/api/admin/2025-01/objects/CompanyAddress): CompanyAddress - The address used as billing address for the location.
* [buyerExperienceConfiguration](/docs/api/admin/2025-01/objects/BuyerExperienceConfiguration): BuyerExperienceConfiguration - The configuration for the buyer's B2B checkout.
* [catalogsCount](/docs/api/admin/2025-01/objects/Count): Count - The number of catalogs associated with the company location. Limited to a maximum of 10000.
* [company](/docs/api/admin/2025-01/objects/Company): Company! - The company that the company location belongs to.
* [createdAt](/docs/api/admin/2025-01/scalars/DateTime): DateTime! - The date and time ([ISO 8601 format](http://en.wikipedia.org/wiki/ISO_8601)) at which the company location was created in Shopify.
* [currency](/docs/api/admin/2025-01/enums/CurrencyCode): CurrencyCode! - The location's currency based on the shipping address. If the shipping address is empty, then the value is the shop's primary market.
* [defaultCursor](/docs/api/admin/2025-01/scalars/String): String! - A default [cursor](https://shopify.dev/api/usage/pagination-graphql) that returns the single next record, sorted ascending by ID.
* [externalId](/docs/api/admin/2025-01/scalars/String): String - A unique externally-supplied ID for the company location.
* [hasTimelineComment](/docs/api/admin/2025-01/scalars/Boolean): Boolean! - Whether the merchant added a timeline comment to the company location.
* [id](/docs/api/admin/2025-01/scalars/ID): ID! - A globally-unique ID.
* [inCatalog](/docs/api/admin/2025-01/scalars/Boolean): Boolean! - Whether the company location is assigned a specific catalog.
* [locale](/docs/api/admin/2025-01/scalars/String): String - The preferred locale of the company location.
* [market](/docs/api/admin/2025-01/objects/Market): Market! - The market that includes the location's shipping address. If the shipping address is empty, then the value is the shop's primary market.
* [metafield](/docs/api/admin/2025-01/objects/Metafield): Metafield - 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.
* [name](/docs/api/admin/2025-01/scalars/String): String! - The name of the company location.
* [note](/docs/api/admin/2025-01/scalars/String): String - A note about the company location.
* [orderCount](/docs/api/admin/2025-01/scalars/Int): Int! - The total number of orders placed for the location.
* [ordersCount](/docs/api/admin/2025-01/objects/Count): Count - The total number of orders placed for the location.
* [phone](/docs/api/admin/2025-01/scalars/String): String - The phone number of the company location.
* [shippingAddress](/docs/api/admin/2025-01/objects/CompanyAddress): CompanyAddress - The address used as shipping address for the location.
* [taxExemptions](/docs/api/admin/2025-01/enums/TaxExemption): TaxExemption! - The list of tax exemptions applied to the location.
* [taxRegistrationId](/docs/api/admin/2025-01/scalars/String): String - The tax registration ID for the company location.
* [taxSettings](/docs/api/admin/2025-01/objects/CompanyLocationTaxSettings): CompanyLocationTaxSettings! - The tax settings for the company location.
* [totalSpent](/docs/api/admin/2025-01/objects/MoneyV2): MoneyV2! - The total amount spent by the location.
* [updatedAt](/docs/api/admin/2025-01/scalars/DateTime): DateTime! - The date and time ([ISO 8601 format](http://en.wikipedia.org/wiki/ISO_8601)) at which the company location was last modified.

## Connections
* [catalogs](/docs/api/admin/2025-01/connections/CatalogConnection): CatalogConnection!
* [draftOrders](/docs/api/admin/2025-01/connections/DraftOrderConnection): DraftOrderConnection!
* [events](/docs/api/admin/2025-01/connections/EventConnection): EventConnection!
* [metafieldDefinitions](/docs/api/admin/2025-01/connections/MetafieldDefinitionConnection): MetafieldDefinitionConnection!
* [metafields](/docs/api/admin/2025-01/connections/MetafieldConnection): MetafieldConnection!
* [orders](/docs/api/admin/2025-01/connections/OrderConnection): OrderConnection!
* [roleAssignments](/docs/api/admin/2025-01/connections/CompanyContactRoleAssignmentConnection): CompanyContactRoleAssignmentConnection!
* [staffMemberAssignments](/docs/api/admin/2025-01/connections/CompanyLocationStaffMemberAssignmentConnection): CompanyLocationStaffMemberAssignmentConnection!



## Related queries
* [companyLocation](/docs/api/admin/2025-01/queries/companyLocation) Returns a `CompanyLocation` object by ID.
* [companyLocations](/docs/api/admin/2025-01/queries/companyLocations) Returns the list of company locations in the shop.

## Related mutations
* [companyLocationAssignTaxExemptions](/docs/api/admin/2025-01/mutations/companyLocationAssignTaxExemptions) Assigns tax exemptions to the company location.
* [companyLocationCreate](/docs/api/admin/2025-01/mutations/companyLocationCreate) Creates a company location.
* [companyLocationCreateTaxRegistration](/docs/api/admin/2025-01/mutations/companyLocationCreateTaxRegistration) Creates a tax registration for a company location.
* [companyLocationRevokeTaxExemptions](/docs/api/admin/2025-01/mutations/companyLocationRevokeTaxExemptions) Revokes tax exemptions from the company location.
* [companyLocationRevokeTaxRegistration](/docs/api/admin/2025-01/mutations/companyLocationRevokeTaxRegistration) Revokes tax registration on a company location.
* [companyLocationTaxSettingsUpdate](/docs/api/admin/2025-01/mutations/companyLocationTaxSettingsUpdate) Sets the tax settings for a company location.
* [companyLocationUpdate](/docs/api/admin/2025-01/mutations/companyLocationUpdate) Updates a company location.

## Related Unions
* [MetafieldReferencer](/docs/api/admin/2025-01/unions/MetafieldReferencer) Types of resources that may use metafields to reference other resources.

## Examples