---
title: CustomerMergePreview - GraphQL Admin
description: A preview of the results of a customer merge request.
api_version: 2025-10
api_name: admin
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerMergePreview
  md: https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerMergePreview.md
---

# Customer​Merge​Preview

object

Requires `read_customer_merge` access scope.

A preview of the results of a customer merge request.

## Fields

* alternate​Fields

  [Customer​Merge​Preview​Alternate​Fields](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerMergePreviewAlternateFields)

  The fields that can be used to override the default fields.

* blocking​Fields

  [Customer​Merge​Preview​Blocking​Fields](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerMergePreviewBlockingFields)

  The fields that will block the merge if the two customers are merged.

* customer​Merge​Errors

  [\[Customer​Merge​Error!\]](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerMergeError)

  The errors blocking the customer merge.

* default​Fields

  [Customer​Merge​Preview​Default​Fields](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerMergePreviewDefaultFields)

  The fields that will be kept if the two customers are merged.

* resulting​Customer​Id

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

  The resulting customer ID if the two customers are merged.

***

## Map

No referencing types

***

## Queries

* [customer​Merge​Preview](https://shopify.dev/docs/api/admin-graphql/latest/queries/customerMergePreview)

  query

  Returns a preview of a customer merge request.

***

## \<?>CustomerMergePreview Queries

### Queried by

* \<?>[customer​Merge​Preview](https://shopify.dev/docs/api/admin-graphql/latest/queries/customerMergePreview)