Source: https://ai-sdk.dev/docs/troubleshooting/react-maximum-update-depth-exceeded

AI SDK

Menu

v5 (Latest)

AI SDK 5.x

AI SDK by Vercel

AI SDK 6 Beta

Foundations

Overview

Providers and Models

Prompts

Tools

Streaming

Getting Started

Navigating the Library

Next.js App Router

Next.js Pages Router

Svelte

Vue.js (Nuxt)

Node.js

Expo

Agents

Agents

Building Agents

Workflow Patterns

Loop Control

AI SDK Core

Overview

Generating Text

Generating Structured Data

Tool Calling

Model Context Protocol (MCP) Tools

Prompt Engineering

Settings

Embeddings

Image Generation

Transcription

Speech

Language Model Middleware

Provider & Model Management

Error Handling

Testing

Telemetry

AI SDK UI

Overview

Chatbot

Chatbot Message Persistence

Chatbot Resume Streams

Chatbot Tool Usage

Generative User Interfaces

Completion

Object Generation

Streaming Custom Data

Error Handling

Transport

Reading UIMessage Streams

Message Metadata

Stream Protocols

AI SDK RSC

Advanced

Reference

AI SDK Core

AI SDK UI

AI SDK RSC

Stream Helpers

AI SDK Errors

Migration Guides

Troubleshooting

Azure OpenAI Slow to Stream

Client-Side Function Calls Not Invoked

Server Actions in Client Components

useChat/useCompletion stream output contains 0:... instead of text

Streamable UI Errors

Tool Invocation Missing Result Error

Streaming Not Working When Deployed

Streaming Not Working When Proxied

Getting Timeouts When Deploying on Vercel

Unclosed Streams

useChat Failed to Parse Stream

Server Action Plain Objects Error

useChat No Response

Custom headers, body, and credentials not working with useChat

TypeScript performance issues with Zod and AI SDK 5

useChat "An error occurred"

Repeated assistant messages in useChat

onFinish not called when stream is aborted

Tool calling with generateObject and streamObject

Abort breaks resumable streams

streamText fails silently

Streaming Status Shows But No Text Appears

Stale body values with useChat

Type Error with onToolCall

Unsupported model version error

Object generation failed with OpenAI

Model is not assignable to type "LanguageModelV1"

TypeScript error "Cannot find namespace 'JSX'"

React error "Maximum update depth exceeded"

Jest: cannot find module '@ai-sdk/rsc'

Copy markdown

React error "Maximum update depth exceeded"

=====================================================================================================================================================================

Issue

---

I am using the AI SDK in a React project with the useChat or useCompletion hooks and I get the following error when AI responses stream in: Maximum update depth exceeded.

Background

---

By default, the UI is re-rendered on every chunk that arrives. This can overload the rendering, especially on slower devices or when complex components need updating (e.g. Markdown). Throttling can mitigate this.

Solution

---

Use the experimental_throttle option to throttle the UI updates:

useChat

page.tsx

const { messages, ... } = useChat({  // Throttle the messages and data updates to 50ms:  experimental_throttle: 50})

useCompletion

page.tsx

const { completion, ... } = useCompletion({  // Throttle the completion and data updates to 50ms:  experimental_throttle: 50})

On this page

React error "Maximum update depth exceeded"

Issue

Background

Solution

useChat

useCompletion

Deploy and Scale AI Apps with Vercel.

Vercel delivers the infrastructure and developer experience you need to ship reliable AI-powered applications at scale.

Trusted by industry leaders:

• OpenAI
• Photoroom
• 
• 

Talk to an expert