---
title: customerMergePreview - GraphQL Admin
description: Returns a preview of a customer merge request.
api_version: 2025-10
api_name: admin
type: query
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/queries/customermergepreview
  md: https://shopify.dev/docs/api/admin-graphql/latest/queries/customermergepreview.md
---

# customer​Merge​Preview

query

Requires `read_customer_merge` access scope.

Returns a preview of a customer merge request.

## Arguments

* customer​One​Id

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

  required

  The ID of the first customer that will be merged.

* customer​Two​Id

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

  required

  The ID of the second customer that will be merged.

* override​Fields

  [Customer​Merge​Override​Fields](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/CustomerMergeOverrideFields)

  The fields to override the default customer merge rules.

***

## Possible returns

* Customer​Merge​Preview

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

  A preview of the results of a customer merge request.

***

## Examples

* ### customerMergePreview reference

## Query Reference

```graphql
{
  customerMergePreview(customerOneId, customerTwoId) {
    # customerMergePreview fields
  }
}
```