---
title: user - Shop Users API
description: Entry point to user-scoped queries.
api_version: unstable latest
source_url:
  html: https://shopify.dev/docs/api/shop-users/latest/queries/user
  md: https://shopify.dev/docs/api/shop-users/latest/queries/user.md
---

# user

query

Entry point to user-scoped queries.

## Possible returns

* User

  [User!](https://shopify.dev/docs/api/shop-users/latest/objects/User)

  The authenticated user.

  * \_​empty

    [Boolean](https://shopify.dev/docs/api/shop-users/latest/scalars/Boolean)

    Reserved placeholder field. The Users API does not yet expose user-scoped fields directly; use top-level queries like `metafield`/`metafields` and mutations like `metafieldsSet`/`metafieldDelete`.

***

## Examples

* ### user reference