---
title: StaffMember - GraphQL Admin
description: >-
  A user account that can access the Shopify admin to manage store operations.
  Includes personal information and account status.


  You can assign staff members to
  [`CompanyLocation`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyLocation)
  objects for [B2B operations](https://shopify.dev/docs/apps/build/b2b),
  limiting their actions to those locations.
api_version: unstable
api_name: admin
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/unstable/objects/StaffMember'
  md: 'https://shopify.dev/docs/api/admin-graphql/unstable/objects/StaffMember.md'
---

# Staff​Member

object

Requires `read_users` access scope. Also: The app must be a finance embedded app or installed on a Shopify Plus or Advanced store. Contact Shopify Support to enable this scope for your app.

A user account that can access the Shopify admin to manage store operations. Includes personal information and account status.

You can assign staff members to [`CompanyLocation`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyLocation) objects for [B2B operations](https://shopify.dev/docs/apps/build/b2b), limiting their actions to those locations.

## Fields

* account​Type

  [Account​Type](https://shopify.dev/docs/api/admin-graphql/unstable/enums/AccountType)

  The type of account the staff member has.

* active

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

  non-null

  Whether the staff member is active.

* avatar

  [Image!](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Image)

  non-null

  The image used as the staff member's avatar in the Shopify admin.

  * max​Width

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

    Deprecated

    ### Arguments

  * max​Height

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

    Deprecated

  * fallback

    [Staff​Member​Default​Image](https://shopify.dev/docs/api/admin-graphql/unstable/enums/StaffMemberDefaultImage)

    Default:DEFAULT

    The default image returned if the staff member has no avatar.

  ***

* email

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

  non-null

  The staff member's email address.

* exists

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

  non-null

  Whether the staff member's account exists.

* first​Name

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

  The staff member's first name.

* id

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

  non-null

  A globally-unique ID.

* identity​Account

  [Identity​Account](https://shopify.dev/docs/api/admin-graphql/unstable/objects/IdentityAccount)

  The Identity account details for the staff member.

* initials

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

  The staff member's initials, if available.

* is​Shop​Owner

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

  non-null

  Whether the staff member is the shop owner.

* last​Name

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

  The staff member's last name.

* locale

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

  non-null

  The staff member's preferred locale. Locale values use the format `language` or `language-COUNTRY`, where `language` is a two-letter language code, and `COUNTRY` is a two-letter country code. For example: `en` or `en-US`

* name

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

  non-null

  The staff member's full name.

* phone

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

  The staff member's phone number.

* private​Data

  [Staff​Member​Private​Data!](https://shopify.dev/docs/api/admin-graphql/unstable/objects/StaffMemberPrivateData)

  non-null

  The data used to customize the Shopify admin experience for the staff member.

* identity​Account​Url

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

  Deprecated

***

## Map

### Fields and connections with this object

* {}[CashTrackingAdjustment.staffMember](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CashTrackingAdjustment#field-CashTrackingAdjustment.fields.staffMember)
* {}[CashTrackingSession.closingStaffMember](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CashTrackingSession#field-CashTrackingSession.fields.closingStaffMember)
* {}[CashTrackingSession.openingStaffMember](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CashTrackingSession#field-CashTrackingSession.fields.openingStaffMember)
* {}[CommentEvent.author](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CommentEvent#field-CommentEvent.fields.author)
* {}[CompanyLocationStaffMemberAssignment.staffMember](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CompanyLocationStaffMemberAssignment#field-CompanyLocationStaffMemberAssignment.fields.staffMember)
* {}[InventoryAdjustmentGroup.staffMember](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryAdjustmentGroup#field-InventoryAdjustmentGroup.fields.staffMember)
* {}[LineItem.staffMember](https://shopify.dev/docs/api/admin-graphql/unstable/objects/LineItem#field-LineItem.fields.staffMember)
* {}[Metaobject.createdByStaff](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Metaobject#field-Metaobject.fields.createdByStaff)
* {}[MetaobjectDefinition.createdByStaff](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectDefinition#field-MetaobjectDefinition.fields.createdByStaff)
* {}[Order.staffMember](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Order#field-Order.fields.staffMember)
* {}[OrderAgreement.user](https://shopify.dev/docs/api/admin-graphql/unstable/objects/OrderAgreement#field-OrderAgreement.fields.user)
* {}[OrderEditAgreement.user](https://shopify.dev/docs/api/admin-graphql/unstable/objects/OrderEditAgreement#field-OrderEditAgreement.fields.user)
* {}[OrderTransaction.user](https://shopify.dev/docs/api/admin-graphql/unstable/objects/OrderTransaction#field-OrderTransaction.fields.user)
* {}[Refund.staffMember](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Refund#field-Refund.fields.staffMember)
* {}[RefundAgreement.user](https://shopify.dev/docs/api/admin-graphql/unstable/objects/RefundAgreement#field-RefundAgreement.fields.user)
* {}[Return.staffMember](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Return#field-Return.fields.staffMember)
* {}[ReturnAgreement.user](https://shopify.dev/docs/api/admin-graphql/unstable/objects/ReturnAgreement#field-ReturnAgreement.fields.user)
* ||-[SalesAgreement.user](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/SalesAgreement#fields-user)
* {}[Shop.accountOwner](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Shop#field-Shop.fields.accountOwner)
* <->[StaffMemberConnection.nodes](https://shopify.dev/docs/api/admin-graphql/unstable/connections/StaffMemberConnection#returns-nodes)
* {}[StaffMemberEdge.node](https://shopify.dev/docs/api/admin-graphql/unstable/objects/StaffMemberEdge#field-StaffMemberEdge.fields.node)
* {}[TenderTransaction.user](https://shopify.dev/docs/api/admin-graphql/unstable/objects/TenderTransaction#field-TenderTransaction.fields.user)

***

## Queries

* [current​Staff​Member](https://shopify.dev/docs/api/admin-graphql/unstable/queries/currentStaffMember)

  query

  The staff member making the API request.

* [staff​Member](https://shopify.dev/docs/api/admin-graphql/unstable/queries/staffMember)

  query

  Retrieves a [staff member](https://shopify.dev/docs/api/admin-graphql/latest/objects/StaffMember) by ID. If no ID is provided, the query returns the staff member that's making the request. A staff member is a user who can access the Shopify admin to manage store operations.

  Provides staff member details such as email, name, and shop owner status. When querying the current user (with or without an ID), additional [private data](https://shopify.dev/docs/api/admin-graphql/latest/queries/staffMember#returns-StaffMember.fields.privateData) becomes available.

  * id

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

    ### Arguments

    The ID of the staff member to return. If no ID is provided, then the staff member making the query (if any) is returned.

  ***

* [staff​Members](https://shopify.dev/docs/api/admin-graphql/unstable/queries/staffMembers)

  query

  Returns a paginated list of [`StaffMember`](https://shopify.dev/docs/api/admin-graphql/latest/objects/StaffMember) objects for the shop. Staff members are users who can access the Shopify admin to manage store operations.

  Supports filtering by account type, email, and name, with an option to sort results. The query returns a [`StaffMemberConnection`](https://shopify.dev/docs/api/admin-graphql/latest/connections/StaffMemberConnection) for [cursor-based pagination](https://shopify.dev/docs/api/usage/pagination-graphql).

  * first

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

    ### Arguments

    The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

  * after

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

    The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

  * last

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

    The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

  * before

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

    The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

  * reverse

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

    Default:false

    Reverse the order of the underlying list.

  * sort​Key

    [Staff​Members​Sort​Keys](https://shopify.dev/docs/api/admin-graphql/unstable/enums/StaffMembersSortKeys)

    Default:ID

    Sort the underlying list using a key. If your query is slow or returns an error, then [try specifying a sort key that matches the field used in the search](https://shopify.dev/api/usage/pagination-graphql#search-performance-considerations).

  * query

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

    A filter made up of terms, connectives, modifiers, and comparators. You can apply one or more filters to a query. Learn more about [Shopify API search syntax](https://shopify.dev/api/usage/search-syntax).

    * * account\_type

        string

      * email

        string

      - Filter by account type.

      - Valid values:

        * `collaborator`
        * `collaborator_team_member`
        * `invited`
        * `regular`
        * `requested`
        * `restricted`
        * `saml`

        Filter by email.

    * first\_name

      string

      Filter by first name.

    * * id

        id

      * last\_name

        string

      - Filter by `id` range.

      - Example:

        * `id:1234`
        * `id:>=1234`
        * `id:<=1234`

        Filter by last name.

  ***

***

## \<?>StaffMember Queries

### Queried by

* \<?>[current​Staff​Member](https://shopify.dev/docs/api/admin-graphql/unstable/queries/currentStaffMember)
* \<?>[staff​Member](https://shopify.dev/docs/api/admin-graphql/unstable/queries/staffMember)
* \<?>[staff​Members](https://shopify.dev/docs/api/admin-graphql/unstable/queries/staffMembers)

***

## Interfaces

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

  interface

***

## ||-StaffMember Implements

### Implements

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