SDK Migration Guide (Next Major Version)

Migration guide for @elevenlabs/client, @elevenlabs/react, and @elevenlabs/react-native breaking changes in the next major release.

Migration order

Follow these steps in sequence — each builds on the previous one.

1. Install the new packages.
2. Fix imports — remove deleted exports (Input, Output, DeviceFormatConfig, DeviceInputConfig, ElevenLabsProvider) and replace with their successors.
3. Wrap with ConversationProvider — every useConversation call now requires a provider ancestor.
4. Update API calls — adapt to changed signatures (startSession is now sync in React, Conversation is no longer a class, etc.).
5. Optimize with granular hooks (optional) — replace local state with useConversationStatus, useConversationMode, etc. for better render performance.

Installation

npm install @elevenlabs/client@next @elevenlabs/react@next @elevenlabs/react-native@next