Shopify attributes

This guide contains a list of the Shopify attributes which are automatically collected through the Shopify Integration.

AttributeValue format
legacyResourceIdShopify customer identifier.
Number. Example: 4435209126053.
acceptsMarketingWhether the customer has consented to receive marketing material via email.
Number. Example:0.
acceptsMarketingUpdatedAtThe date and time (ISO 8601 format) when the customer consented or objected to receiving marketing material by email.
Date. Example: 2021-02-02T10:23:58Z.
addressesA list of the ten most recently updated addresses for the customer.
Array. See address object for detailed description of each entry in the array.
averageOrderAmountV2The average amount that the customer spent per order.
Array. Example: { "amount": "0.00", "currencyCode": "EUR" }.
canDeleteWhether the merchant can delete the customer from their store.
Number. Example:1.
createdAtThe date and time (ISO 8601 format) when the customer was created.
Date. Example: 2021-02-02T10:23:58Z
defaultAddressThe default address for the customer. Same properties as address.
Array. See address object for detailed description of each entry in the array.
displayNameThe full name of the customer, based on the values for first_name and last_name. If these values are not available, then this falls back to the customer's email address, and if that is not available, the customer's phone number.
String. Example: John Doe
emailThe unique email address of the customer.
String. Example: [email protected]
firstNameThe customer's first name.
String. Example:John
lastNameThe customer's last name.
String. Example:Doe
hasNoteWhether the customer has a note associated with them.
Number. Example:0
hasTimelineCommentWhether the merchant has added timeline comments about the customer on the customer's page.
Number. Example:0
lifetimeDurationThe amount of time since the customer was first added to the store.
String. Example: about 1 month
localeThe customer's language.
String. Example:en
marketingOptInLevelThe marketing subscription opt-in that the customer gave when they consented to receive marketing material by email.
Number.
noteA note about the customer.
String. Example: Repeating customer
ordersCountThe number of orders associated with this customer.
Number. Example: 14
lastOrderCustomer’s last order information.
See last order object for detailed description of each property.
stateThe state of the customer's account with a shop. Default value: disabled.
String. Valid values:

disabled: The customer doesn't have an active account. Customer accounts can be disabled from the Shopify admin at any time.
invited: The customer has received an email invite to create an account.
enabled: The customer has created an account.
declined: The customer declined the email invite to create an account.
tagsTags that the shop owner has attached to the customer, formatted as a string of comma-separated values.
Array. Example: [example1,example2]
taxExemptWhether the customer is exempt from paying taxes on their order. If 1, then taxes won't be applied to an order at checkout. If 0, then taxes will be applied at checkout.
Number. Example:0
taxExemptionsWhether the customer is exempt from paying specific taxes on their order. Canadian taxes only. See Shopify's documentation for valid values (under tax_exemptions).
Array. Example:[ "CA_STATUS_CARD_EXEMPTION", "CA_BC_RESELLER_EXEMPTION" ]
totalSpentThe total amount of money that the customer has spent across their order history.
Number. Example: 50.76
totalSpentV2The total amount of money with currency that the customer has spent across their order history.
Array. Example: { "amount": "0.00", "currencyCode": "EUR" }
updatedAtThe date and time (ISO 8601 format) when the customer information was last updated.
Date. Example: 2021-02-12T12:36:03Z
validEmailAddressWhether the email address is valid.
Number. Example:1
verifiedEmailWhether the customer has verified their email address.
Number. Example:1

Address object

A list of the ten most recently updated addresses for the customer. Each address has the following properties:

PropertyDescription
address1The customer's mailing address.
Example:Sunset Blvd, 92
address2An additional field for the customer's address.
Example: Apt. 2
cityThe customer's city, town, or village.
Example: Louisville
companyThe customer's company.
Example: Clara Enterprises Inc.
countryThe customer's country.
Example: US
country_codeTwo-letter country code corresponding to the customer's country.
Example: US
country_nameThe customer's normalized country name.
Example: United States
customer_idA unique identifier for the customer.
Example: 6940095564
defaultWhether this address is the default address for the customer. Boolean.
Example: true
first_nameThe customer's first name.
Example: Clara
idA unique identifier for the address.
Example: 207119551
last_nameThe customer's last name.
Example: Norman
nameThe customer's first and last names.
Example: Clara Norman
phoneThe customer's phone number at this address.
Example: 555-625-1199
provinceThe customer's region name. Typically a province, a state, or a prefecture.
Example: Kentucky
province_codeThe code for the region of the address, such as the province, state, or district. For example QC for Quebec, Canada.
zipThe customer's postal code, also known as zip, postcode, Eircode, etc.
Example: 40202

Example:

{
    "id": 207119551,
    "customer_id": 6940095564,
    "first_name": "Clara",
    "last_name": "Norman",
    "company": null,
    "address1": "Sunset Blvd, 92",
    "address2": "Apt. 2",
    "city": "Louisville",
    "province": "Kentucky",
    "country": "US",
    "zip": "40202",
    "phone": "555-625-1199",
    "province_code": "KY",
    "country_code": "US",
    "country_name": "United States",
    "default": true
}

Last order object

Customer’s last order information. Has these properties:

PropertyDescription
idA unique id for the customer
Example: gid://shopify/Order/3744530170021
cancelReasonReason the order was canceled. Returns null if the order wasn't canceled.
Example: declined
cancelledAtDate and time the order was canceled. Returns null if the order wasn't canceled.
Example: 2021-05-15T13:04:22Z
cartDiscountAmountSetAmount of the order-level discount (does not contain any line item discounts) in shop and presentment currencies.
Example: 29.99
closedWhether the order is closed. Boolean.
Example: false
closedAtDate and time when the order closed. If the order is not closed, then this field is null.
Example: 2021-05-15T16:05:11Z
confirmedWhether inventory has been reserved for the order. Boolean.
Example: true
createdAtDate and time when the order was created in Shopify
Example: 2021-04-15T13:59:31Z
currentSubtotalLineItemsQuantityThe sum of the quantities for the line items that contribute to the order's subtotal.
Example: 1
currentSubtotalPriceSetThe subtotal of line items and their discounts minus the line items that have been returned. This includes order-level discounts, unless the argument with_cart_discount is set to false. This doesn't include shipping costs and shipping discounts. Taxes are not included unless the order is a taxes-included order.
Example:
{ "presentmentMoney": { "amount": "0.5", "currencyCode": "EUR" }, "shopMoney": { "amount": "0.5", "currencyCode": "EUR" } }
currentTotalDiscountsSetThe total amount discounted from the order (including order-level and line item discounts) minus the amounts for items that have been returned.
Example: { "presentmentMoney": { "amount": "0.0", "currencyCode": "EUR" } }
currentTotalPriceSetThe total amount of the order (including taxes and discounts) minus the amounts for line items that have been returned.
Example: { "presentmentMoney": { "amount": "0.5", "currencyCode": "EUR" } }
displayFulfillmentStatusFulfillment status for the order that can be shown to the merchant. This field does not capture all the possible details of an order's fulfillment state. It should only be used for display summary purposes.
Example: UNFULFILLED
totalDiscountsSetTotal amount discounted from the order (include order-level and line item discounts) in shop and presentment currencies.
Example: { "presentmentMoney": { "amount": "0.0", "currencyCode": "EUR" }
totalPriceSetTotal amount of the order (includes taxes and discounts) in shop and presentment currencies.
Example: { "presentmentMoney": { "amount": "0.5", "currencyCode": "EUR" }
totalRefundedSetTotal amount refunded for the order in shop and presentment currencies.
Example: { "presentmentMoney": { "amount": "0.0", "currencyCode": "EUR" }, "shopMoney": { "amount": "0.0", "currencyCode": "EUR" } }

Example:

{
    "id": "gid://shopify/Order/3744530170021",
    "cancelReason": null,
    "cancelledAt": null,
    "cartDiscountAmountSet": null,
    "closed": false,
    "closedAt": null,
    "confirmed": true,
    "createdAt": "2021-04-15T13:59:31Z",
    "currentSubtotalLineItemsQuantity": 1,
    "currentSubtotalPriceSet": {
        "presentmentMoney": {
            "amount": "0.5",
            "currencyCode": "EUR"
        },
        "shopMoney": {
            "amount": "0.5",
            "currencyCode": "EUR"
        }
    },
    "currentTotalDiscountsSet": {
        "presentmentMoney": {
            "amount": "0.0",
            "currencyCode": "EUR"
        }
    },
    "currentTotalPriceSet": {
        "presentmentMoney": {
            "amount": "0.5",
            "currencyCode": "EUR"
        }
    },
    "displayFulfillmentStatus": "UNFULFILLED",
    "edited": false,
    "email": "[email protected]",
    "fulfillable": true,
    "phone": null,
    "shippingAddress": null,
    "totalDiscountsSet": {
        "presentmentMoney": {
            "amount": "0.0",
            "currencyCode": "EUR"
        },
        "shopMoney": {
            "amount": "0.0",
            "currencyCode": "EUR"
        }
    },
    "totalPriceSet": {
        "presentmentMoney": {
            "amount": "0.5",
            "currencyCode": "EUR"
        },
        "shopMoney": {
            "amount": "0.5",
            "currencyCode": "EUR"
        }
    },
    "totalRefundedSet": {
        "presentmentMoney": {
            "amount": "0.0",
            "currencyCode": "EUR"
        },
        "shopMoney": {
            "amount": "0.0",
            "currencyCode": "EUR"
        }
    }
}

The info in this page is summarised from Shopify's docs.