---
title: CustomerMergeable - GraphQL Admin
description: An object that represents whether a customer can be merged with another customer.
api_version: 2025-10
api_name: admin
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/objects/customermergeable
  md: https://shopify.dev/docs/api/admin-graphql/latest/objects/customermergeable.md
---

# Customer​Mergeable

object

Requires The user must have `read_customer_merge` permissions.

An object that represents whether a customer can be merged with another customer.

## Fields

* error​Fields

  [\[Customer​Merge​Error​Field​Type!\]!](https://shopify.dev/docs/api/admin-graphql/latest/enums/CustomerMergeErrorFieldType)

  non-null

  The list of fields preventing the customer from being merged.

* is​Mergeable

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

  non-null

  Whether the customer can be merged with another customer.

* merge​In​Progress

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

  The merge request if one is currently in progress.

* reason

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

  The reason why the customer can't be merged with another customer.

***

## Map

### Fields with this object

* {}[Customer.mergeable](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer#field-Customer.fields.mergeable)
* {}[CustomerSegmentMember.mergeable](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerSegmentMember#field-CustomerSegmentMember.fields.mergeable)