Skip to content
Saleor
Esc
↑↓navigate↵open⌘Jpreview

Schema: Saleor 3.23.43Download SDLUpgrade guides

On this page

customers Query

List of the shop’s customers. This list includes all users who registered through the accountRegister mutation. Additionally, staff users who have placed an order using their account will also appear in this list.

Requires one of the following permissions:MANAGE_ORDERSMANAGE_USERS
customers(filter: CustomerFilterInput, where: CustomerWhereInput, sortBy: UserSortingInput, search: String, before: String, after: String, first: Int, last: Int): UserCountableConnection

Returns

UserCountableConnection

Show return type
type UserCountableConnection {
  pageInfo: PageInfo!
  edges: [UserCountableEdge!]!
  totalCount: Int
}

Arguments

filter

filter · CustomerFilterInput

Filtering options for customers.

where

where · CustomerWhereInput

Where filtering options for customers.

Added in Saleor 3.22

sortBy

sortBy · UserSortingInput

Sort customers.

search · String

Search customers.

Added in Saleor 3.22

before

before · String

Return the elements in the list that come before the specified cursor.

after

after · String

Return the elements in the list that come after the specified cursor.

first

first · Int

Retrieve the first n elements from the list. Note that the system only allows fetching a maximum of 100 objects in a single query.

last

last · Int

Retrieve the last n elements from the list. Note that the system only allows fetching a maximum of 100 objects in a single query.


Schema: Saleor 3.23.43. Download SDL.

Last updated on April 13, 2026

Was this page helpful?