Query examples
Query examplesMeta Values

Meta Values

Read more in guide Working with Meta Values.

These are examples of queries to fetch meta data, and filter results by meta.

Querying meta

Fetch single meta value _thumbnail_id from posts:

{
  posts {
    id
    title
    metaValue(key: "_thumbnail_id")
  }
}

Fetch array meta value upvotes from comments:

{
  comments {
    id
    content
    upvotes: metaValues(key: "upvotes")
  }
}

Filtering by meta

Filter posts where meta key _thumbnail_id exists:

{
  posts(filter: {
    metaQuery: {
      key: "_thumbnail_id",
      compareBy:{
        key: {
          operator: EXISTS
        }
      }
    }
  }) {
    id
    title
    metaValue(key: "_thumbnail_id")
  }
}

Filter users where meta entry nickname has a certain value:

{
  users(filter: {
    metaQuery: {
      key: "nickname",
      compareBy:{
        stringValue: {
          value: "leo"
          operator: EQUALS
        }
      }
    }
  }) {
    id
    name
    metaValue(key: "nickname")
  }
}

Filter comments where meta entry upvotes (which is an array of integers) has either values 4 or 5:

{
  comments(filter: {
    metaQuery: [
      {
        relation: OR
        key: "upvotes",
        compareBy: {
          arrayValue: {
            value: 4
            operator: IN
          }
        }
      },
      {
        key: "upvotes",
        compareBy: {
          arrayValue: {
            value: 5
            operator: IN
          }
        }
      }
  ]}) {
    id
    content
    upvotes: metaValues(key: "upvotes")
  }
}
Prev
Next