--- title: MailingAddress - Storefront API description: |- A physical mailing address associated with a [`Customer`](/docs/api/storefront/2026-04/objects/Customer) or [`Order`](/docs/api/storefront/2026-04/objects/Order). Stores standard address components including street address, city, province, country, and postal code, along with customer name and company information. The address includes geographic coordinates and provides pre-formatted output through the [`formatted`](/docs/api/storefront/2026-04/objects/MailingAddress#field-MailingAddress.fields.formatted) field, which can optionally include or exclude name and company details. api_version: 2026-04 source_url: html: https://shopify.dev/docs/api/storefront/latest/objects/mailingaddress md: https://shopify.dev/docs/api/storefront/latest/objects/mailingaddress.md --- # Mailing​Address object A physical mailing address associated with a [`Customer`](https://shopify.dev/docs/api/storefront/2026-04/objects/Customer) or [`Order`](https://shopify.dev/docs/api/storefront/2026-04/objects/Order). Stores standard address components including street address, city, province, country, and postal code, along with customer name and company information. The address includes geographic coordinates and provides pre-formatted output through the [`formatted`](https://shopify.dev/docs/api/storefront/2026-04/objects/MailingAddress#field-MailingAddress.fields.formatted) field, which can optionally include or exclude name and company details. ## Fields * address1 [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) The first line of the address. Typically the street address or PO Box number. * address2 [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) The second line of the address. Typically the number of the apartment, suite, or unit. * city [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) The name of the city, district, village, or town. * company [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) The name of the customer's company or organization. * country [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) The name of the country. * country​Code​V2 [Country​Code](https://shopify.dev/docs/api/storefront/latest/enums/CountryCode) The two-letter code for the country of the address. For example, US. * first​Name [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) The first name of the customer. * formatted [\[String!\]!](https://shopify.dev/docs/api/storefront/latest/scalars/String) non-null A formatted version of the address, customized by the provided arguments. * with​Company [Boolean](https://shopify.dev/docs/api/storefront/latest/scalars/Boolean) Default:true ### Arguments Whether to include the customer's company in the formatted address. * with​Name [Boolean](https://shopify.dev/docs/api/storefront/latest/scalars/Boolean) Default:false Whether to include the customer's name in the formatted address. *** * formatted​Area [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) A comma-separated list of the values for city, province, and country. * id [ID!](https://shopify.dev/docs/api/storefront/latest/scalars/ID) non-null A globally-unique ID. * last​Name [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) The last name of the customer. * latitude [Float](https://shopify.dev/docs/api/storefront/latest/scalars/Float) The latitude coordinate of the customer address. * longitude [Float](https://shopify.dev/docs/api/storefront/latest/scalars/Float) The longitude coordinate of the customer address. * name [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) The full name of the customer, based on firstName and lastName. * phone [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) A unique phone number for the customer. Formatted using E.164 standard. For example, *+16135551111*. * province [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) The region of the address, such as the province, state, or district. * province​Code [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) The alphanumeric code for the region. For example, ON. * zip [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) The zip or postal code of the address. * country​Code [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) Deprecated *** ## Map ### Fields and connections with this object * [CartDeliveryGroup.deliveryAddress](https://shopify.dev/docs/api/storefront/latest/objects/CartDeliveryGroup#field-CartDeliveryGroup.fields.deliveryAddress) * [Customer.addresses](https://shopify.dev/docs/api/storefront/latest/objects/Customer#field-Customer.fields.addresses) * [Customer.defaultAddress](https://shopify.dev/docs/api/storefront/latest/objects/Customer#field-Customer.fields.defaultAddress) * [MailingAddressConnection.nodes](https://shopify.dev/docs/api/storefront/latest/connections/MailingAddressConnection#returns-nodes) * [MailingAddressEdge.node](https://shopify.dev/docs/api/storefront/latest/objects/MailingAddressEdge#field-MailingAddressEdge.fields.node) * [Order.billingAddress](https://shopify.dev/docs/api/storefront/latest/objects/Order#field-Order.fields.billingAddress) * [Order.shippingAddress](https://shopify.dev/docs/api/storefront/latest/objects/Order#field-Order.fields.shippingAddress) ### Possible type in * [Delivery​Address](https://shopify.dev/docs/api/storefront/latest/unions/DeliveryAddress) *** ## Mutations * [customer​Address​Create](https://shopify.dev/docs/api/storefront/latest/mutations/customerAddressCreate) mutation Creates a new [`MailingAddress`](https://shopify.dev/docs/api/storefront/2026-04/objects/MailingAddress) for a [`Customer`](https://shopify.dev/docs/api/storefront/2026-04/objects/Customer). Use the customer's [access token](https://shopify.dev/docs/api/storefront/2026-04/mutations/customerAddressCreate#arguments-customerAccessToken) to identify them. Successful creation returns the new address. Each customer can have multiple addresses. * address [Mailing​Address​Input!](https://shopify.dev/docs/api/storefront/latest/input-objects/MailingAddressInput) required ### Arguments The customer mailing address to create. * customer​Access​Token [String!](https://shopify.dev/docs/api/storefront/latest/scalars/String) required The access token used to identify the customer. *** * [customer​Address​Update](https://shopify.dev/docs/api/storefront/latest/mutations/customerAddressUpdate) mutation Updates an existing [`MailingAddress`](https://shopify.dev/docs/api/storefront/2026-04/objects/MailingAddress) for a [`Customer`](https://shopify.dev/docs/api/storefront/2026-04/objects/Customer). Requires a [customer access token](https://shopify.dev/docs/api/storefront/2026-04/mutations/customerAddressUpdate#arguments-customerAccessToken) to identify the customer, an ID to specify which address to modify, and an [`address`](https://shopify.dev/docs/api/storefront/2026-04/input-objects/MailingAddressInput) with the updated fields. Successful update returns the updated [`MailingAddress`](https://shopify.dev/docs/api/storefront/2026-04/objects/MailingAddress). * address [Mailing​Address​Input!](https://shopify.dev/docs/api/storefront/latest/input-objects/MailingAddressInput) required ### Arguments The customer’s mailing address. * customer​Access​Token [String!](https://shopify.dev/docs/api/storefront/latest/scalars/String) required The access token used to identify the customer. * id [ID!](https://shopify.dev/docs/api/storefront/latest/scalars/ID) required Specifies the customer address to update. *** *** ## MailingAddress Mutations ### Mutated by * [customer​Address​Create](https://shopify.dev/docs/api/storefront/latest/mutations/customerAddressCreate) * [customer​Address​Update](https://shopify.dev/docs/api/storefront/latest/mutations/customerAddressUpdate) *** ## Interfaces * [Node](https://shopify.dev/docs/api/storefront/latest/interfaces/Node) interface *** ## MailingAddress Implements ### Implements * [Node](https://shopify.dev/docs/api/storefront/latest/interfaces/Node)