--- 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: 2025-10 api_name: admin type: object api_type: graphql source_url: html: https://shopify.dev/docs/api/admin-graphql/latest/objects/staffmember md: https://shopify.dev/docs/api/admin-graphql/latest/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/latest/enums/AccountType) The type of account the staff member has. * active [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean) non-null Whether the staff member is active. * avatar [Image!](https://shopify.dev/docs/api/admin-graphql/latest/objects/Image) non-null The image used as the staff member's avatar in the Shopify admin. * email [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-null The staff member's email address. * exists [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean) non-null Whether the staff member's account exists. * first​Name [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) The staff member's first name. * id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) non-null A globally-unique ID. * initials [\[String!\]](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) The staff member's initials, if available. * is​Shop​Owner [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean) non-null Whether the staff member is the shop owner. * last​Name [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) The staff member's last name. * locale [String!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/scalars/String) non-null The staff member's full name. * phone [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) The staff member's phone number. * private​Data [Staff​Member​Private​Data!](https://shopify.dev/docs/api/admin-graphql/latest/objects/StaffMemberPrivateData) non-null The data used to customize the Shopify admin experience for the staff member. *** ## Map ### Fields and connections with this object * {}[CashTrackingAdjustment.staffMember](https://shopify.dev/docs/api/admin-graphql/latest/objects/CashTrackingAdjustment#field-CashTrackingAdjustment.fields.staffMember) * {}[CashTrackingSession.closingStaffMember](https://shopify.dev/docs/api/admin-graphql/latest/objects/CashTrackingSession#field-CashTrackingSession.fields.closingStaffMember) * {}[CashTrackingSession.openingStaffMember](https://shopify.dev/docs/api/admin-graphql/latest/objects/CashTrackingSession#field-CashTrackingSession.fields.openingStaffMember) * {}[CommentEvent.author](https://shopify.dev/docs/api/admin-graphql/latest/objects/CommentEvent#field-CommentEvent.fields.author) * {}[CompanyLocationStaffMemberAssignment.staffMember](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyLocationStaffMemberAssignment#field-CompanyLocationStaffMemberAssignment.fields.staffMember) * {}[InventoryAdjustmentGroup.staffMember](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryAdjustmentGroup#field-InventoryAdjustmentGroup.fields.staffMember) * {}[LineItem.staffMember](https://shopify.dev/docs/api/admin-graphql/latest/objects/LineItem#field-LineItem.fields.staffMember) * {}[Metaobject.createdByStaff](https://shopify.dev/docs/api/admin-graphql/latest/objects/Metaobject#field-Metaobject.fields.createdByStaff) * {}[MetaobjectDefinition.createdByStaff](https://shopify.dev/docs/api/admin-graphql/latest/objects/MetaobjectDefinition#field-MetaobjectDefinition.fields.createdByStaff) * {}[Order.staffMember](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order#field-Order.fields.staffMember) * {}[OrderAgreement.user](https://shopify.dev/docs/api/admin-graphql/latest/objects/OrderAgreement#field-OrderAgreement.fields.user) * {}[OrderEditAgreement.user](https://shopify.dev/docs/api/admin-graphql/latest/objects/OrderEditAgreement#field-OrderEditAgreement.fields.user) * {}[OrderTransaction.user](https://shopify.dev/docs/api/admin-graphql/latest/objects/OrderTransaction#field-OrderTransaction.fields.user) * {}[Refund.staffMember](https://shopify.dev/docs/api/admin-graphql/latest/objects/Refund#field-Refund.fields.staffMember) * {}[RefundAgreement.user](https://shopify.dev/docs/api/admin-graphql/latest/objects/RefundAgreement#field-RefundAgreement.fields.user) * {}[ReturnAgreement.user](https://shopify.dev/docs/api/admin-graphql/latest/objects/ReturnAgreement#field-ReturnAgreement.fields.user) * ||-[SalesAgreement.user](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/SalesAgreement#fields-user) * {}[Shop.accountOwner](https://shopify.dev/docs/api/admin-graphql/latest/objects/Shop#field-Shop.fields.accountOwner) * <->[StaffMemberConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/StaffMemberConnection#returns-nodes) * {}[StaffMemberEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/StaffMemberEdge#field-StaffMemberEdge.fields.node) * {}[TenderTransaction.user](https://shopify.dev/docs/api/admin-graphql/latest/objects/TenderTransaction#field-TenderTransaction.fields.user) *** ## Queries * [current​Staff​Member](https://shopify.dev/docs/api/admin-graphql/latest/queries/currentStaffMember) query The staff member making the API request. * [staff​Member](https://shopify.dev/docs/api/admin-graphql/latest/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. * [staff​Members](https://shopify.dev/docs/api/admin-graphql/latest/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). *** ## \StaffMember Queries ### Queried by * \[current​Staff​Member](https://shopify.dev/docs/api/admin-graphql/latest/queries/currentStaffMember) * \[staff​Member](https://shopify.dev/docs/api/admin-graphql/latest/queries/staffMember) * \[staff​Members](https://shopify.dev/docs/api/admin-graphql/latest/queries/staffMembers) *** ## Interfaces * [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node) interface *** ## ||-StaffMember Implements ### Implements * ||-[Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)