Manually update Apollo cache after GraphQL mutation

Ensuring that GraphQL mutations properly update your Apollo client's cache can be a bit tricky - here's how to manually control that.

Table of contents

    Unless a mutation mutates a single existing entity, you'll need to use a specific update function to ensure data updates returned by the mutation are propagated.

    Your call to the useMutation hook can take an update callback function, which takes two arguments: a DataProxy object allowing you to interact with Apollo's cache store, and a FetchResult object containing data returned by the mutation.

    The DataProxy object can be interacted with using readQuery and writeData methods to read existing cache data and update entries, respectively.

    // This mutation is something that does not represent an existing entity,
    // note that no ID is returned.
    const SOME_MUTATION = gql`
      mutation ($something: String!) {
        foo (something: $something) {
          bar {
    const BAR_QUERY = gql`
      query ($id: ID!) {
        bar (id: $id) {
    function Foobar() {
      const [mutate, { data }] = useMutation(SOME_MUTATION);
      // Run the mutation at component mount
        () => {
            variables: { something: 'something' },
            update: (store, { data: { foo: { bar } } }) {
                query: BAR_QUERY,
                data: { bar },
                variables: { id: }
      return <div>{data && JSON.stringify(data)}</div>;

    When you then execute BAR_QUERY with any of the fetchPolicy options that involve reading from cache, you'll find that the cache will work.

    Note that it could often be a better idea to think about how to remodel the resource so that it can have an id field returned by the API, or configuring the cache with a dataIdFromObject function to infer an ID from the type so that it can be treated as something cacheable. Nonetheless, it's good to keep the writeQuery solution in mind, as you don't always have control over the API you need to consume.

    Download our ebook
    Michał Buszkiewicz, Elixir Developer
    Michał Buszkiewicz Curiosum Founder & CTO

    Read more
    on #curiosum blog

    The little story of Elixir programming language

    The Elixir language, operating on an Erlang machine, is constantly gaining more and more followers. Where can these languages be used? How was Elixir created and what does it have in common with Erlang?

    Top Elixir Learning Media & Resources in 2022

    Regardless of whether you've only just heard of the Elixir programming language and would like to learn it, or if you're a seasoned developer with years of experience, you need adequate learning resources to ensure steady progress in your career - and just equally as important is the need to be up to date with what's new & trending in the functional