# CompanyLocation - admin-graphql - OBJECT Version: 2024-10 ## 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-graphql/2024-10/objects/CompanyAddress): CompanyAddress - The address used as billing address for the location. * [buyerExperienceConfiguration](/docs/api/admin-graphql/2024-10/objects/BuyerExperienceConfiguration): BuyerExperienceConfiguration - The configuration for the buyer's B2B checkout. * [catalogsCount](/docs/api/admin-graphql/2024-10/objects/Count): Count - The number of catalogs associated with the company location. Limited to a maximum of 10000. * [company](/docs/api/admin-graphql/2024-10/objects/Company): Company! - The company that the company location belongs to. * [createdAt](/docs/api/admin-graphql/2024-10/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-graphql/2024-10/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-graphql/2024-10/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-graphql/2024-10/scalars/String): String - A unique externally-supplied ID for the company location. * [hasTimelineComment](/docs/api/admin-graphql/2024-10/scalars/Boolean): Boolean! - Whether the merchant added a timeline comment to the company location. * [id](/docs/api/admin-graphql/2024-10/scalars/ID): ID! - A globally-unique ID. * [inCatalog](/docs/api/admin-graphql/2024-10/scalars/Boolean): Boolean! - Whether the company location is assigned a specific catalog. * [locale](/docs/api/admin-graphql/2024-10/scalars/String): String - The preferred locale of the company location. * [market](/docs/api/admin-graphql/2024-10/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-graphql/2024-10/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-graphql/2024-10/scalars/String): String! - The name of the company location. * [note](/docs/api/admin-graphql/2024-10/scalars/String): String - A note about the company location. * [orderCount](/docs/api/admin-graphql/2024-10/scalars/Int): Int! - The total number of orders placed for the location. * [ordersCount](/docs/api/admin-graphql/2024-10/objects/Count): Count - The total number of orders placed for the location. * [phone](/docs/api/admin-graphql/2024-10/scalars/String): String - The phone number of the company location. * [privateMetafield](/docs/api/admin-graphql/2024-10/objects/PrivateMetafield): PrivateMetafield - Returns a private metafield by namespace and key that belongs to the resource. * [shippingAddress](/docs/api/admin-graphql/2024-10/objects/CompanyAddress): CompanyAddress - The address used as shipping address for the location. * [taxExemptions](/docs/api/admin-graphql/2024-10/enums/TaxExemption): TaxExemption! - The list of tax exemptions applied to the location. * [taxRegistrationId](/docs/api/admin-graphql/2024-10/scalars/String): String - The tax registration ID for the company location. * [totalSpent](/docs/api/admin-graphql/2024-10/objects/MoneyV2): MoneyV2! - The total amount spent by the location. * [updatedAt](/docs/api/admin-graphql/2024-10/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-graphql/2024-10/connections/CatalogConnection): CatalogConnection! * [draftOrders](/docs/api/admin-graphql/2024-10/connections/DraftOrderConnection): DraftOrderConnection! * [events](/docs/api/admin-graphql/2024-10/connections/EventConnection): EventConnection! * [metafieldDefinitions](/docs/api/admin-graphql/2024-10/connections/MetafieldDefinitionConnection): MetafieldDefinitionConnection! * [metafields](/docs/api/admin-graphql/2024-10/connections/MetafieldConnection): MetafieldConnection! * [orders](/docs/api/admin-graphql/2024-10/connections/OrderConnection): OrderConnection! * [privateMetafields](/docs/api/admin-graphql/2024-10/connections/PrivateMetafieldConnection): PrivateMetafieldConnection! * [roleAssignments](/docs/api/admin-graphql/2024-10/connections/CompanyContactRoleAssignmentConnection): CompanyContactRoleAssignmentConnection! * [staffMemberAssignments](/docs/api/admin-graphql/2024-10/connections/CompanyLocationStaffMemberAssignmentConnection): CompanyLocationStaffMemberAssignmentConnection! ## Related queries * [companyLocation](/docs/api/admin-graphql/2024-10/queries/companyLocation) Returns a `CompanyLocation` object by ID. * [companyLocations](/docs/api/admin-graphql/2024-10/queries/companyLocations) Returns the list of company locations in the shop. ## Related mutations * [companyLocationAssignTaxExemptions](/docs/api/admin-graphql/2024-10/mutations/companyLocationAssignTaxExemptions) Assigns tax exemptions to the company location. * [companyLocationCreate](/docs/api/admin-graphql/2024-10/mutations/companyLocationCreate) Creates a company location. * [companyLocationCreateTaxRegistration](/docs/api/admin-graphql/2024-10/mutations/companyLocationCreateTaxRegistration) Creates a tax registration for a company location. * [companyLocationRevokeTaxExemptions](/docs/api/admin-graphql/2024-10/mutations/companyLocationRevokeTaxExemptions) Revokes tax exemptions from the company location. * [companyLocationRevokeTaxRegistration](/docs/api/admin-graphql/2024-10/mutations/companyLocationRevokeTaxRegistration) Revokes tax registration on a company location. * [companyLocationUpdate](/docs/api/admin-graphql/2024-10/mutations/companyLocationUpdate) Updates a company location. ## Related Unions * [MetafieldReferencer](/docs/api/admin-graphql/2024-10/unions/MetafieldReferencer) Types of resources that may use metafields to reference other resources. ## Examples