---
title: CustomerVisit - GraphQL Admin
description: Represents a customer's session visiting a shop's online store, including information about the marketing activity attributed to starting the session.
api_version: 2025-10
api_name: admin
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerVisit
  md: https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerVisit.md
---

# Customer​Visit

object

Requires `read_orders` access scope or `read_marketplace_orders` access scope.

Represents a customer's session visiting a shop's online store, including information about the marketing activity attributed to starting the session.

## Fields

* id

  [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID)

  non-null

  A globally-unique ID.

* landing​Page

  [URL](https://shopify.dev/docs/api/admin-graphql/latest/scalars/URL)

  URL of the first page the customer landed on for the session.

* landing​Page​Html

  [HTML](https://shopify.dev/docs/api/admin-graphql/latest/scalars/HTML)

  Landing page information with URL linked in HTML. For example, the first page the customer visited was store.myshopify.com/products/1.

* marketing​Event

  [Marketing​Event](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketingEvent)

  Represent actions taken by an app, on behalf of a merchant, to market Shopify resources such as products, collections, and discounts.

* occurred​At

  [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime)

  non-null

  The date and time when the customer's session occurred.

* referral​Code

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  Marketing referral code from the link that the customer clicked to visit the store. Supports the following URL attributes: *ref*, *source*, or *r*. For example, if the URL is myshopifystore.com/products/slide?ref=j2tj1tn2, then this value is j2tj1tn2.

* referral​Info​Html

  [Formatted​String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/FormattedString)

  non-null

  Referral information with URLs linked in HTML.

* referrer​Url

  [URL](https://shopify.dev/docs/api/admin-graphql/latest/scalars/URL)

  Webpage where the customer clicked a link that sent them to the online store. For example, *<https://randomblog.com/page1>* or *android-app\://com.google.android.gm*.

* source

  [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  non-null

  Source from which the customer visited the store, such as a platform (Facebook, Google), email, direct, a website domain, QR code, or unknown.

* source​Description

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  Describes the source explicitly for first or last session.

* source​Type

  [Marketing​Tactic](https://shopify.dev/docs/api/admin-graphql/latest/enums/MarketingTactic)

  Type of marketing tactic.

* utm​Parameters

  [UTMParameters](https://shopify.dev/docs/api/admin-graphql/latest/objects/UTMParameters)

  A set of UTM parameters gathered from the URL parameters of the referrer.

***

## Map

### Fields with this object

* {}[CustomerJourney.firstVisit](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerJourney#field-CustomerJourney.fields.firstVisit)
* {}[CustomerJourney.lastVisit](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerJourney#field-CustomerJourney.fields.lastVisit)
* {}[CustomerJourneySummary.firstVisit](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerJourneySummary#field-CustomerJourneySummary.fields.firstVisit)
* {}[CustomerJourneySummary.lastVisit](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerJourneySummary#field-CustomerJourneySummary.fields.lastVisit)

***

## Interfaces

* * [Customer​Moment](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/CustomerMoment)

    interface

  * [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)

    interface

***

## ||-CustomerVisit Implements

### Implements

* ||-[Customer​Moment](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/CustomerMoment)
* ||-[Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)