---
title: >-
  createdAt is now available on the Customer object in Shopify Functions -
  Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/createdat-is-now-available-on-the-customer-object-in-shopify-functions
  md: >-
    https://shopify.dev/changelog/createdat-is-now-available-on-the-customer-object-in-shopify-functions.md
metadata:
  effectiveApiVersion: 2026-10
  affectedApi:
    - displayName: Functions
      handle: functions-api
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2026-07-28T11:46:01-04:00'
  postedAt: '2026-07-30T12:00:00-04:00'
  updatedAt: '2026-07-30T13:23:56-04:00'
  effectiveAt: '2026-08-04T12:00:00-04:00'
---

July 30, 2026

Tags:

* Functions
* 2026-10

# createdAt is now available on the Customer object in Shopify Functions

Shopify Functions API version `2026-10` adds a `createdAt` field to the `Customer` object. You can now use the date and time a customer account was created in Function logic. This is an additive change; no action is required for existing Functions.

## What changed

The `Customer` object now exposes `createdAt`, which returns the date and time when the customer account was created. This lets you build customizations based on when a customer joined.

To use `createdAt`, request it from the customer on `Cart.buyerIdentity` in the Function input query:

```graphql
query Input {
  cart {
    buyerIdentity {
      customer {
        createdAt
      }
    }
  }
}
```

The customer is available only when the buyer is signed in. Functions should continue to handle guest buyers, where `buyerIdentity` or `customer` might be `null` or omitted.

Earlier Shopify Functions API versions are unchanged. To use the new field:

* Update the Function to API version `2026-10`.
* Add `createdAt` to the Function’s input query.
* Test with both signed-in and guest buyers.

## Related docs

* [Shopify Functions API reference](https://shopify.dev/docs/api/functions/reference)
* [Shopify Functions input queries](https://shopify.dev/docs/apps/build/functions/input-queries)