CompanyLocation

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 that's a customer of the shop. Configuration of B2B relationship, for example prices lists and checkout settings, may be done for a location.

Anchor to Fields and connectionsFields and connections

Anchor to billingAddressbillingAddress • CompanyAddress: The address used as billing address for the location.
Anchor to buyerExperienceConfigurationbuyerExperienceConfiguration • BuyerExperienceConfiguration: The configuration for the buyer's B2B checkout.
Anchor to catalogscatalogs • CatalogConnection!non-null: The list of catalogs associated with the company location.
Anchor to catalogsCountcatalogsCount • Count: The number of catalogs associated with the company location. Limited to a maximum of 10000.
Anchor to companycompany • Company!non-null: The company that the company location belongs to.
Anchor to createdAtcreatedAt • DateTime!non-null: The date and time (ISO 8601 format) at which the company location was created in Shopify.
Anchor to currencycurrency • CurrencyCode!non-null: The location's currency based on the shipping address. If the shipping address is empty, then the value is the shop's primary market.
Anchor to defaultCursordefaultCursor • String!non-null: A default cursor that returns the single next record, sorted ascending by ID.
Anchor to draftOrdersdraftOrders • DraftOrderConnection!non-null: The list of draft orders for the company location.
Anchor to eventsevents • EventConnection!non-null: The paginated list of events associated with the host subject.
Anchor to externalIdexternalId • String: A unique externally-supplied ID for the company location.
Anchor to hasTimelineCommenthasTimelineComment • Boolean!non-null: Whether the merchant added a timeline comment to the company location.
Anchor to idid • ID!non-null: A globally-unique ID.
Anchor to inCataloginCatalog • Boolean!non-null: Whether the company location is assigned a specific catalog.
Anchor to localelocale • String: The preferred locale of the company location.
Anchor to marketmarket • Market!non-null: The market that includes the location's shipping address. If the shipping address is empty, then the value is the shop's primary market.
Anchor to metafieldmetafield • Metafield: A custom field, including its namespace and key, that's associated with a Shopify resource for the purposes of adding and storing additional information.
Anchor to metafieldsmetafields • MetafieldConnection!non-null: A list of custom fields that a merchant associates with a Shopify resource.
Anchor to namename • String!non-null: The name of the company location.
Anchor to notenote • String: A note about the company location.
Anchor to ordersorders • OrderConnection!non-null: The list of orders for the company location.
Anchor to ordersCountordersCount • Count: The total number of orders placed for the location.
Anchor to phonephone • String: The phone number of the company location.
Anchor to roleAssignmentsroleAssignments • CompanyContactRoleAssignmentConnection!non-null: The list of roles assigned to the company location.
Anchor to shippingAddressshippingAddress • CompanyAddress: The address used as shipping address for the location.
Anchor to totalSpenttotalSpent • MoneyV2!non-null: The total amount spent by the location.
Anchor to updatedAtupdatedAt • DateTime!non-null: The date and time (ISO 8601 format) at which the company location was last modified.

Show

deprecated fields and connections Deprecated

Anchor to metafieldDefinitionsmetafieldDefinitions • MetafieldDefinitionConnection!non-nullDeprecated: List of metafield definitions. This field will be removed in a future version. Use the root metafieldDefinitions field instead.
Anchor to orderCountorderCount • Int!non-nullDeprecated: The total number of orders placed for the location. Use ordersCount instead.
Anchor to privateMetafieldprivateMetafield • PrivateMetafieldDeprecated: Returns a private metafield by namespace and key that belongs to the resource. Metafields created using a reserved namespace are private by default. See our guide for migrating private metafields.
Anchor to privateMetafieldsprivateMetafields • PrivateMetafieldConnection!non-nullDeprecated: List of private metafields that belong to the resource. Metafields created using a reserved namespace are private by default. See our guide for migrating private metafields.
Anchor to taxExemptionstaxExemptions • [TaxExemption!]!non-nullDeprecated: The list of tax exemptions applied to the location. Use taxSettings instead.
Anchor to taxRegistrationIdtaxRegistrationId • StringDeprecated: The tax registration ID for the company location. Use taxSettings instead.

Was this section helpful?

Anchor to QueriesQueries

Anchor to companyLocation companyLocation • query: Returns a CompanyLocation object by ID.
Anchor to companyLocations companyLocations • query: Returns the list of company locations in the shop.

Was this section helpful?

Anchor to MutationsMutations

Anchor to companyLocationCreate companyLocationCreate • mutation: Creates a company location.
Anchor to companyLocationUpdate companyLocationUpdate • mutation: Updates a company location.

Show

deprecated mutations Deprecated

Anchor to companyLocationAssignTaxExemptions companyLocationAssignTaxExemptions • mutationDeprecated: Assigns tax exemptions to the company location. Use companyLocationTaxSettingsUpdate instead.
Anchor to companyLocationCreateTaxRegistration companyLocationCreateTaxRegistration • mutationDeprecated: Creates a tax registration for a company location. Use companyLocationTaxSettingsUpdate instead.
Anchor to companyLocationRevokeTaxExemptions companyLocationRevokeTaxExemptions • mutationDeprecated: Revokes tax exemptions from the company location. Use companyLocationTaxSettingsUpdate instead.
Anchor to companyLocationRevokeTaxRegistration companyLocationRevokeTaxRegistration • mutationDeprecated: Revokes tax registration on a company location. Use companyLocationTaxSettingsUpdate instead.

Was this section helpful?

Anchor to InterfacesInterfaces

Anchor to CommentEventSubject CommentEventSubject • interface
Anchor to HasEvents HasEvents • interface
Anchor to HasMetafieldDefinitions HasMetafieldDefinitions • interface
Anchor to HasMetafields HasMetafields • interface
Anchor to Navigable Navigable • interface
Anchor to Node Node • interface

Was this section helpful?